email-sender

name

email-sender

description

邮件发送统一封装工具，支持HTML模板邮件、纯文本邮件、附件发送。内置科技感邮件模板，支持浅色/深色主题自动切换。 Use when: - 发送格式化邮件通知 send formatted email notifications - 发送日报/周报等报告 send daily/weekly reports - 带附件的邮件发送 send emails with attachments - 营销邮件批量发送 batch marketing emails - 会议邀请邮件 meeting invitations - 系统通知邮件 system notifications Cross-references: document-hub, pdf, long-form-writer, rss-feed Part of UniqueClub toolkit. Learn more: https://uniqueclub.ai

Email Sender Skill

邮件发送统一封装，支持HTML模板和纯文本。

When to Use

Use This Skill When

• 需要发送格式化的HTML邮件
• 发送带有品牌样式的营销邮件
• 附件发送（报告、数据文件等）
• 根据时间自动切换邮件主题（白天浅色/晚上深色）
• 发送系统通知或日报/周报
• 需要科技感设计风格的邮件

Do NOT Use This Skill If

• 需要发送大量邮件（可能触发SMTP限制）
• 收件人邮箱服务器有严格过滤
• 网络环境使用VPN/代理（会导致SSL错误）
• 需要复杂的邮件模板定制（超出内置模板）

Typical Trigger Phrases

Chinese:

• "发送邮件"
• "发封报告邮件"
• "HTML邮件"
• "科技感邮件模板"
• "带附件的邮件"
• "日报邮件"

English:

• "Send email"
• "Email report"
• "HTML email template"
• "Send with attachment"
• "Daily report email"
• "Tech-style email"

Workflow

Step 1: 选择邮件类型

函数	场景	特点
send_smart_email()	通用	自动根据时间选主题
send_tech_email()	晚上/深色	科技感深色主题
send_light_email()	白天/浅色	清爽浅色主题
send_email()	简单	纯文本
send_email_with_attachments()	附件	带文件

Step 2: 配置邮件参数

required_params = {
    "to_email": "[e-mail]",
    "subject": "邮件主题",
    "title": "邮件标题",        # HTML模板用
    "content": "邮件正文",       # HTML模板用
}

Step 3: 发送邮件

from skills.email_sender.email_sender import send_smart_email

send_smart_email(
    to_email='[e-mail]',
    subject='AI日报',
    title='今日热点',
    content='<p>内容...</p>'
)

Step 4: 处理异常

• 捕获网络错误
• 处理SMTP认证失败
• 记录发送日志

Guardrails

Email Sending Rules (Updated 2026-03-04)

强制规范:

1. 必须使用模板 - 不允许纯文本邮件

   • 白天 (6:00-18:00) → 使用浅色主题 send_light_email()
   • 晚上 (18:00-6:00) → 使用深色主题 send_tech_email()

2. 默认包含广告 - 默认添加杭州大会广告

   • 除非明确指定 include_ad=False
   • 广告位置：邮件内容底部

Network Environment

⚠️ 重要: 使用邮件功能时请保持国内网络环境

• ✅ 国内直连: SMTP连接正常
• ❌ VPN/代理: SSL握手会被飞书服务器拒绝

错误特征:

SSL: UNEXPECTED_EOF_WHILE_READING
EOF occurred in violation of protocol

解决方案: 关闭VPN，切换国内网络后重试。

Limitations

• 依赖飞书SMTP服务器
• 单账户有发送频率限制
• 附件大小限制（通常25MB）
• 不支持邮件追踪功能

Core Features

1. 智能主题选择

from skills.email_sender.email_sender import send_smart_email

# 自动根据当前时间选择主题（白天浅色/晚上深色）+ 默认广告
send_smart_email(
    to_email='[e-mail]',
    subject='AI日报',
    title='今日热点',
    content='<p>内容...</p>'
)

2. 深色科技感模板

from skills.email_sender.email_sender import send_tech_email

send_tech_email(
    to_email="[e-mail]",
    subject="非凡产研 - AI日报",
    title="🦞 今日AI热点",
    subtitle="2026年3月4日",
    content="""
    <p>今日AI领域发生重大事件...</p>
    <h3>关键洞察</h3>
    <ul>
        <li>Anthropic事件持续发酵</li>
        <li>Claude登顶App Store</li>
    </ul>
    """,
    highlights=[
        {"label": "政策风向", "value": "AI军事化加速"},
        {"label": "资本流向", "value": "基础设施增长"},
        {"label": "用户态度", "value": "卸载量激增295%"}
    ],
    footer="非凡产研 | 连接技术与商业"
)

3. 浅色主题模板

from skills.email_sender.email_sender import send_light_email

send_light_email(
    to_email="[e-mail]",
    subject='早报',
    title='今日热点',
    content='...',
    # 自动包含广告
)

4. 带附件邮件

from skills.email_sender.email_sender import send_email_with_attachments

send_email_with_attachments(
    to_email="[e-mail]",
    subject="带附件的邮件",
    body="请查收附件",
    attachments=[
        ("report.pdf", "/path/to/report.pdf"),
        ("data.xlsx", "/path/to/data.xlsx")
    ]
)

5. 纯文本邮件（不推荐）

from skills.email_sender.email_sender import send_email

send_email(
    to_email="[e-mail]",
    subject="测试邮件",
    body="这是一封测试邮件"
)

Template Color Scheme

元素	深色主题	浅色主题
主背景	#0a0a0f	#ffffff
卡片背景	#12121a	#f5f5f5
主色调	#00d4ff	#0066cc
强调色	#ff6b35	#ff6b35
文字	#e6e6e6	#1a1a1a
次要文字	#888888	#666666

Configuration

SMTP配置（自动从~/.openclaw/.env读取）：

• 服务器: smtp.feishu.cn:465
• 用户名: [e-mail]
• 密码: FEISHU_SMTP_PASSWORD

Related Skills

Skill	Relationship	Use Case
document-hub	附件来源	生成Word/Excel附件
pdf	附件来源	生成PDF报告附件
long-form-writer	内容生成	生成邮件正文内容
rss-feed	数据来源	RSS内容作为邮件素材

Workflow Integration

Workflow: 生成报告 → 发送邮件

from skills.long_form_writer import generate_report
from skills.email_sender.email_sender import send_tech_email

# 生成长文报告
report = generate_report(data, template="daily")

# 发送邮件
send_tech_email(
    to_email="[e-mail]",
    subject="🦞 卓然AI日报",
    title="今日AI热点",
    content=report.html_content,
    highlights=report.key_insights
)

Workflow: 生成PDF → 邮件附件

from skills.document_hub.document_hub import write
from skills.email_sender.email_sender import send_email_with_attachments

# 生成报告文档
write("report.docx", content)

# 发送带附件邮件
send_email_with_attachments(
    to_email="[e-mail]",
    subject="月度报告",
    body="请查收附件中的月度报告",
    attachments=[("月度报告.docx", "./report.docx")]
)

Dependencies

• Python 3.7+
• 无需额外依赖（使用标准库 smtplib）

Changelog

• 2026-03-04: 初始版本，封装邮件发送功能，添加科技感HTML模板

About UniqueClub

Part of the UniqueClub toolkit - a collection of skills for AI-powered content creation and automation.