核心用法
send-email 是一款轻量级的邮件发送技能,通过 Python 标准库 smtplib 实现 SMTP 协议通信。用户需在 ~/.openclaw/openclaw.json 中预配置 SMTP 服务器地址、端口、发件人邮箱及授权码/应用密码,OpenClaw 会在脚本运行时自动将配置注入为环境变量。使用时直接调用 Python 脚本,支持纯文本邮件和带附件邮件两种模式,兼容 163、Gmail、QQ 等主流邮箱服务商。
显著优点
1. 安全设计规范:凭据完全通过环境变量注入,无硬编码风险;明确禁止读取配置文件以避免敏感信息泄露;使用 SSL/TLS 加密传输。
2. 零第三方依赖:仅依赖 Python 标准库,无 pip 安装负担,部署简单可靠。
3. 多服务商兼容:内置 163、Gmail、QQ 等主流邮箱的配置参考,降低用户配置门槛。
4. 边界处理完善:参数校验、文件存在性检查、异常捕获等机制健全,错误提示清晰且不泄露敏感信息。
潜在缺点与局限性
1. 功能单一:仅支持基础的文本邮件和单附件发送,不支持 HTML 邮件、多附件、邮件模板、抄送/密送等高级功能。
2. 配置前置依赖:需要用户手动完成 SMTP 配置,对不熟悉邮箱授权码机制的用户有一定学习成本。
3. T3 来源风险:虽代码本身安全,但来源于社区个人开发者,长期维护更新存在不确定性。
4. 无发送队列机制:大量邮件发送时无速率控制,可能触发服务商反垃圾策略。
适合的目标群体
- 需要自动化邮件通知的开发者与运维人员
- 希望集成邮件报告功能的 Agent 工作流用户
- 使用 163/Gmail/QQ 等个人或企业邮箱进行轻量级邮件发送的场景
使用风险
- 凭据管理风险:配置文件权限设置不当可能导致 SMTP 密码泄露
- 附件误发风险:脚本不校验附件内容敏感性,需用户自行确认
- 服务商限制风险:各邮箱服务商对发送频率和数量有限制,超限可能导致账号受限
- 网络依赖风险:SMTP 服务可用性依赖外部网络环境