核心功能
email-resend是一个基于Resend API的邮件收发技能,为OpenClaw代理提供完整的邮件处理能力。该技能无需配置文件,通过环境变量和OpenClaw上下文自动获取设置,支持发送、接收、回复和附件管理四大核心场景。
显著优点
1. 零配置启动:自动从OpenClaw上下文读取用户邮箱、频道等信息,首次使用时通过交互式提示补全缺失配置
2. 完善的线程管理:强制使用draft-reply.py工作流,自动处理In-Reply-To和References头,确保Gmail等客户端正确显示线程
3. 智能通知系统:支持15分钟CRON轮询,邮件到达时自动推送至Telegram/Discord等频道,含重要性分级(🔥高优先级/📅会议/📬普通)
4. 附件全链路支持:支持发送多附件、下载入站邮件附件,API路径特殊处理(/emails/receiving/{id}/attachments)
5. custody chain追踪:完整的DAG结构记录邮件→通知→回复的全链路,支持审计追踪
潜在局限
- 依赖单一服务商:完全绑定Resend API,无法切换至SendGrid、AWS SES等替代方案
- Python脚本依赖:需要本地Python环境和
requests库,容器化场景需额外处理 - 无内置加密:邮件内容以明文形式通过Resend传输,敏感业务需额外端到端加密
- 审批执行风险:2026-02-22更新特别强调,用户批准后必须立即执行
draft-reply.py send,否则易造成"已确认但未发送"的状态不一致
适合人群
- 需要邮件自动化的小型团队(客服通知、订单确认)
- 开发者优先的轻量级邮件集成场景
- 已通过Resend验证域名的现有用户
- 需要与即时通讯(Telegram/Discord)联动的混合工作流
常规风险
| 风险项 | 等级 | 说明 |
|--------|------|------|
| API密钥泄露 | 高 | `RESEND_API_KEY`需妥善保管,泄露可能导致邮件滥用 |
| 线程断裂 | 中 | 误用`outbound.py`回复会导致Gmail线程断裂,上下文丢失 |
| 审批执行遗漏 | 中 | 用户批准后未立即执行send命令,造成状态不一致 |
| 附件大小限制 | 低 | 受Resend平台限制(通常25MB)|
安全建议
- 将
RESEND_API_KEY存储于加密环境变量或密钥管理系统 - 生产环境启用Resend的Webhook签名验证(如支持)
- 定期轮换API密钥并监控发送配额