AgentMail —— 通过 AgentMail 为代理提供专用电子邮件收件箱

{/* 此页面由 website/scripts/generate-skill-docs.py 从技能的 SKILL.md 自动生成。请编辑源文件 SKILL.md，而非此页面。 */}

AgentMail

通过 AgentMail 为代理提供专用电子邮件收件箱。使用代理拥有的电子邮件地址（例如 hermes-agent@agentmail.to）自主发送、接收和管理电子邮件。

技能元数据

来源	可选 —— 使用 hermes skills install official/email/agentmail 安装
路径	optional-skills/email/agentmail
版本	1.0.0
平台	linux, macos, windows
标签	email, communication, agentmail, mcp

参考：完整 SKILL.md

:::info 以下是 Hermes 在触发此技能时加载的完整技能定义。这是技能激活时代理所看到的指令。 :::

AgentMail —— 代理拥有的电子邮件收件箱

前提条件

• AgentMail API 密钥（必须）—— 在 https://console.agentmail.to 注册（免费层：3 个收件箱，每月 3,000 封邮件；付费计划从 $20/月起）
• Node.js 18+（用于 MCP 服务器）

使用时机

在需要以下功能时使用此技能：

• 为代理提供专用电子邮件地址
• 代表代理自主发送电子邮件
• 接收和阅读传入邮件
• 管理邮件线程和对话
• 通过电子邮件注册服务或进行身份验证
• 通过电子邮件与其他代理或人类通信

此技能不是用于读取用户的个人电子邮件（请使用 himalaya 或 Gmail）。 AgentMail 为代理提供自己的身份和收件箱。

设置

1. 获取 API 密钥

• 前往 https://console.agentmail.to
• 创建账户并生成 API 密钥（以 am_ 开头）

2. 配置 MCP 服务器

添加到 ~/.hermes/config.yaml（粘贴您的实际密钥 —— MCP 环境变量不会从 .env 展开）：

mcp_servers:
  agentmail:
    command: "npx"
    args: ["-y", "agentmail-mcp"]
    env:
      AGENTMAIL_API_KEY: "***"

3. 重启 Hermes

hermes

现在所有 11 个 AgentMail 工具自动可用。

可用工具（通过 MCP）

工具	描述
list_inboxes	列出所有代理收件箱
get_inbox	获取特定收件箱的详情
create_inbox	创建新收件箱（获得真实电子邮件地址）
delete_inbox	删除收件箱
list_threads	列出收件箱中的邮件线程
get_thread	获取特定邮件线程
send_message	发送新邮件
reply_to_message	回复现有邮件
forward_message	转发邮件
update_message	更新邮件标签/状态
get_attachment	下载邮件附件

操作步骤

创建收件箱并发送邮件

1. 创建专用收件箱：
   • 使用 create_inbox 指定用户名（例如 hermes-agent）
   • 代理获得地址：hermes-agent@agentmail.to
2. 发送邮件：
   • 使用 send_message 指定 inbox_id, to, subject, text
3. 检查回复：
   • 使用 list_threads 查看传入对话
   • 使用 get_thread 阅读特定线程

检查传入邮件

1. 使用 list_inboxes 查找您的收件箱 ID
2. 使用 list_threads 指定收件箱 ID 查看对话
3. 使用 get_thread 阅读线程及其消息

回复邮件

1. 使用 get_thread 获取线程
2. 使用 reply_to_message 指定消息 ID 和回复文本

示例工作流

注册服务：

1. create_inbox (username: "signup-bot")
2. 使用收件箱地址在服务上注册
3. list_threads 检查验证邮件
4. get_thread 阅读验证码

代理到人类的联络：

1. create_inbox (username: "hermes-outreach")
2. send_message (to: user@example.com, subject: "您好", text: "...")
3. list_threads 检查回复

注意事项

• 免费层限制为 3 个收件箱和每月 3,000 封邮件
• 免费层邮件来自 @agentmail.to 域名（付费计划可使用自定义域名）
• MCP 服务器需要 Node.js 18+（npx -y agentmail-mcp）
• 必须安装 mcp Python 包：pip install mcp
• 实时入站邮件（webhook）需要公共服务器 —— 个人使用请通过 cronjob 使用 list_threads 轮询

验证

设置后，使用以下命令测试：

hermes --toolsets mcp -q "创建一个名为 test-agent 的 AgentMail 收件箱，告诉我它的电子邮件地址"

应返回新的收件箱地址。

参考

• AgentMail 文档：https://docs.agentmail.to/
• AgentMail 控制台：https://console.agentmail.to
• AgentMail MCP 仓库：https://github.com/agentmail-to/agentmail-mcp
• 定价：https://www.agentmail.to/pricing