用途：AgentMail 让智能体拥有自己的邮箱地址，用于发信、收信、处理邮件 OTP 流程、回复、会话线程、标签与附件，并支持入站邮件的 webhook 或 WebSocket 投递。它面向智能体自有的收件箱，不用于用户已有的 IMAP/SMTP 邮箱。
主要能力：管理收件箱、发送与读取邮件、回复、转发、标签、会话线程和附件；支持通过 webhook 将事件推送到公网 HTTPS 服务器，或通过 WebSocket 推送到本地智能体进程；提供 MCP 集成。
使用方式：优先使用 agentmail CLI；仅当运行环境需要 MCP 工具时使用 MCP；仅当 CLI 缺少所需操作时使用 REST。通过终端工具运行命令。安装：npm install -g agentmail-cli@latest。导出 API 密钥：export AGENTMAIL_API_KEY="am_..."。当其他命令或脚本需要 ID 时，使用 --format json，例如：agentmail inboxes list --format json。若尚无 API 密钥，按 signup.md 完成自助注册与 OTP 验证。核心流程参考 core.md，入站推送参考 webhooks.md 或 websockets.md，MCP 参考 mcp.md。
限制与注意事项：优先使用 AGENTMAIL_API_KEY 而非 --api-key；切勿在提示词、日志、URL 或提交文件中暴露 AGENTMAIL_API_KEY；重试创建操作时使用稳定的 client_id；当存在 extracted_text 或 extracted_html 时，优先将其用于 LLM 输入；应响应 message.received，而不是智能体自己发出的邮件。验证方式：agentmail inboxes list --format json。