用途：通过 AgentMail API 为 AI 智能体提供程序化电子邮件能力，支持创建收件箱、收发消息、管理线程、Webhook、Pod 和自定义域名。触发场景包括发送邮件、创建收件箱、检查邮件、读取消息、邮件 Webhook 等。
主要能力：Inbox 是可收发邮件的地址（如 random123@agentmail.to）；Pod 是共享域名的多收件箱容器；Thread 是按主题/引用分组的会话；Message 是线程中的单封邮件；Draft 是发送前可编辑的未发送消息。支持发送、回复、转发、附件（base64 编码）、标签过滤、指标统计、异步客户端与 WebSocket 实时更新。
使用方式：需设置 AGENTMAIL_API_KEY 环境变量，密钥从 https://agentmail.to 获取。可安装 Python SDK：pip install agentmail。CLI 包装脚本常用命令如 ./scripts/agentmail-cli inboxes list、inboxes create [--username NAME] [--domain DOMAIN]、send --inbox-id ID --to "email@example.com" --subject "Hello" --text "Body"、messages list --inbox-id ID、messages get --inbox-id ID --message-id MSG_ID、reply --inbox-id ID --message-id MSG_ID --text "Reply body"、threads list --inbox-id ID、webhooks create --url "https://..." --events "message.received"。Python SDK 可直接调用 client.inboxes.create()、client.inboxes.messages.send(...)、reply、forward、drafts、webhooks、pods、domains 等接口。
适用场景：为每个用户创建专属收件箱、轮询新邮件、处理并归档消息、以智能体身份发送带签名的邮件。
限制与安全提示：Webhook 接收外部邮件存在提示注入风险，官方建议用 OpenClaw webhook transform 建立可信发件人允许列表（~/.openclaw/hooks/email-allowlist.ts），未通过校验的邮件直接丢弃，配置于 ~/.openclaw/openclaw.yaml 后执行 openclaw gateway restart；还可采用隔离会话、不可信标记、智能体训练等防御层。错误处理可捕获 ApiError，检查 status_code（如 404 收件箱不存在、429 限流）。其余参考资料见 references/API.md、references/WEBHOOKS.md、references/EXAMPLES.md，文档 https://docs.agentmail.to，Python SDK https://github.com/agentmail-to/agentmail-python。