邮件发送工具

技能简介

该技能提供命令行邮件发送能力，同时支持传统SMTP协议与Resend云服务两种投递方式，可发送纯文本、HTML格式邮件并携带附件。

业务背景

该工具为运维、开发及业务团队提供灵活的命令行邮件通知能力。无论是系统告警、报表推送还是自动化流程通知，均可通过SMTP或Resend双通道可靠投递，支持富文本与附件，满足日常办公与生产环境的基础邮件触达需求。

落地案例：某技术团队将邮件发送工具集成至CI/CD流水线，在构建失败时自动向负责人推送带日志附件的告警邮件；财务部门则用于定期发送加密报表，利用HTML格式呈现数据看板。配置一次即可在SMTP企业邮箱与Resend云服务间无缝切换，规避单点故障风险。

能做什么

• 通过SMTP或Resend API发送邮件
• 支持纯文本与HTML两种内容格式
• 添加单个或多个文件附件
• 自动在Resend与SMTP之间切换备用通道
• 兼容163、QQ、Gmail、Outlook等主流邮箱

使用说明

安装与配置

1. 克隆仓库后进入项目目录
2. 创建配置文件 ~/.smtp_config，选择以下任一方式：
   • Resend方式：填写 resend_api_key 和 resend_from
   • SMTP方式：填写 host、port、user、password、from、use_ssl
3. 设置文件权限：chmod 600 ~/.smtp_config

发送邮件

# 简单邮件
python3 scripts/send_email.py --to user@example.com --subject "标题" --body "正文"

# HTML邮件（加 --html）
python3 scripts/send_email.py --to user@example.com --subject "标题" --body "<h1>内容</h1>" --html

# 带附件（多个用逗号分隔）
python3 scripts/send_email.py --to user@example.com --subject "资料" --body "请查收" --attachments file.pdf,data.csv

输入与输出

见下方输入与输出表格。

风险提示

• 配置文件含敏感凭据，务必设置600权限且勿提交至代码仓库
• 163/QQ/Gmail需使用授权码而非登录密码
• Resend免费账户仅限向注册邮箱发送，外发需验证域名
• 企业内网可能拦截465/587端口，需提前确认网络策略

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/xiwan/smtp-send/SKILL.md
来源类型：开源技能库