QQ邮箱 SMTP 发信

要解决什么问题

在 OpenClaw 或自动化流水线里发邮件，常见痛点是：脚本里写死绝对路径，换机器就要改配置；AI 只能交互式点选，没法稳定传参；发出去有没有成功、发给谁、写了什么，事后很难对账。本技能面向 QQ 邮箱 SMTP，把「可迁移部署 + 可脚本调用 + 可追溯日志」绑在一起。

技能如何工作

运行约定是以技能根目录 send-txmail/ 为工作目录，路径随技能目录自适应，不依赖宿主机上的固定目录。

• 双模式：交互式适合人工填收件人、主题与正文；命令行模式面向 AI/定时任务，通过参数一次性提交发送请求（文档建议 AI 优先用命令行）。
• SMTP：走 QQ 邮箱加密通道（典型为 465 端口），凭 config.json 中的账号与 16 位授权码（非登录密码）完成认证。
• 强制日志：每次发送自动落盘，字段包含发送时间（秒级）、收件人、主题、完整正文、成功/失败结果；日志路径同样相对技能目录，迁移时无需改代码。
• 调试：提供调试模式，便于在认证或网络异常时缩小问题范围。

典型用法包括：OpenClaw 在对话中触发发信、cron 定时通知、以及按列表批量发送（由外层脚本循环调用命令行模式即可）。

适用边界与注意点

• 仅覆盖 QQ 邮箱 SMTP 发信，不是通用多厂商邮件网关；换邮箱需改配置与授权方式。
• 授权码过期或填错会表现为认证失败，需在 QQ 邮箱设置里重新开启 SMTP/IMAP 并更新 config.json。
• 连接失败时先查网络与 465 是否可达；日志目录无写入权限时会出现「发了但无记录」——需检查 scripts 相关目录权限。
• 日志会保留完整邮件正文，适合审计，也意味着敏感内容会长期留在磁盘，部署时要考虑访问控制与留存策略。