custom-smtp-sender

Custom SMTP Sender 是一款基于 Python 标准库开发的命令行邮件发送工具，专为需要将邮件功能集成到自动化工作流的技术团队设计。该工具通过读取本地 SMTP 配置文件（/home/bb/.openclaw/smtp-config.json）完成身份验证，支持 Markdown 语法自动转换为 HTML、多附件上传以及智能失败重试机制，用户可通过简洁的 CLI 参数快速构造并发送复杂格式的邮件内容。

该工具的显著优势体现在其零外部依赖的架构设计上，完全基于 Python 内置的 smtplib、email、json 等标准库实现，彻底消除了第三方包可能带来的供应链攻击风险。功能层面，它不仅支持纯文本与 HTML 双格式输出，还内置了最多 3 次的自动重试逻辑和完整的操作日志记录，确保关键通知的可靠投递与事后审计。安全性方面，敏感凭据采用外部配置文件隔离存储，避免了硬编码带来的代码泄露风险，同时官方明确建议用户通过 chmod 600 严格限制配置文件的访问权限，实现权限最小化原则。

然而，该技能也存在一定的使用局限性。首先，它要求用户预先手动创建并正确配置 SMTP 凭据文件，对非技术背景用户存在明显的上手门槛；其次，当前版本缺少对 CC/BCC 抄送功能的支持，也不具备邮箱地址格式验证和附件文件存在性预检查机制，输入错误时可能产生运行时异常。此外，所有邮件内容构造均依赖本地文件系统读取，在容器化、沙箱或受限权限环境中可能遇到文件访问问题。

该技能特别适合后端开发者、DevOps 工程师以及需要构建自动化通知系统的系统管理员。典型应用场景包括：CI/CD 流水线构建结果通知、定时任务执行状态报告、系统监控报警邮件发送、定期数据报表自动分发等。对于需要大规模发送营销邮件或处理高度敏感机密数据的场景，建议充分评估 SMTP 服务商的安全策略与发送频率限制后再做选择。

使用过程中需重点关注以下潜在风险：配置文件若未按规范设置权限（600）可能导致凭据被同服务器其他用户读取；附件路径参数若未仔细核对，存在意外发送包含敏感信息的错误文件的可能性；在网络环境不可信（如公共 Wi-Fi）的情况下通过 SMTP 传输邮件内容存在被中间人攻击截获的风险。建议配合专用 SMTP 服务账号（避免使用个人主邮箱）使用，并定期审查日志审计记录以发现异常发送行为。