MailChannels邮件发送

技能简介

通过MailChannels Email API发送邮件，并将签名的投递事件Webhook接入Clawdbot（Moltbot）进行状态跟踪。

能做什么

• 调用REST API发送单封或批量邮件
• 异步队列发送降低延迟
• 接收并验证投递事件Webhook（送达、退信、丢弃等）
• 自动关联内部消息ID与MailChannels请求ID

使用说明

1. 环境准备：设置MAILCHANNELS_API_KEY和MAILCHANNELS_ACCOUNT_ID环境变量
2. DNS配置：在发件域名添加TXT记录_mailchannels.<domain>，值为v=mc1; auid=<ACCOUNT_ID>
3. 安装依赖：确保系统已安装curl
4. 发送邮件：POST到/send或/send-async，必填字段包括personalizations、from、subject、content
5. 启用Webhook：在~/.clawdbot/moltbot.json中开启hooks，映射路径到代理动作
6. 注册端点：调用POST /webhook?endpoint=<你的URL>完成订阅
7. 验证签名：解析Signature-Input头，获取公钥，重建RFC 9421签名基底，校验ed25519签名

输入与输出

见下方输入与输出表格。

风险提示

• Webhook签名验证失败可能导致伪造事件被处理
• 未配置DNS Domain Lockdown会导致邮件被拒收
• created时间戳过期检查缺失会引入重放攻击风险
• 自行实现ed25519验签容易出错，建议使用成熟库

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/ttulttul/mailchannels/SKILL.md
来源类型：GitHub仓库