跳到主要内容

Agentmail

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

技能元数据​

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

参考：完整 SKILL.md​

信息

以下是 Hermes 在触发此技能时加载的完整技能定义。这是技能激活时智能体看到的指令。

AgentMail — 智能体拥有的电子邮件收件箱

要求​

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

何时使用​

当您需要执行以下操作时，请使用此技能：

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

这不用于读取用户的个人电子邮件（为此请使用 himalaya 或 Gmail）。 AgentMail 赋予智能体其自身的身份和收件箱。

设置​

1. 获取 API 密钥​

2. 配置 MCP 服务器​

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

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

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. 创建专用收件箱：
    • 使用用户名（例如 hermes-agent）调用 create_inbox
    • 智能体获得地址：hermes-agent@agentmail.to
  2. 发送电子邮件：
    • 使用 send_message，参数包括 inbox_id、to、subject、text
  3. 检查回复：
    • 使用 list_threads 查看 incoming 对话
    • 使用 get_thread 阅读特定线程

检查 incoming 电子邮件​

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

回复电子邮件​

  1. 使用 get_thread 获取线程
  2. 使用 reply_to_message，传入消息 ID 和您的回复文本

示例工作流​

注册服务：

1. create_inbox (username: "signup-bot")
2. Use the inbox address to register on the service
3. list_threads to check for verification email
4. get_thread to read the verification code

智能体向人类外联：

1. create_inbox (username: "hermes-outreach")
2. send_message (to: user@example.com, subject: "Hello", text: "...")
3. list_threads to check for replies

常见陷阱​

  • 免费层级限制为 3 个收件箱和每月 3,000 封邮件
  • 免费层级的电子邮件来自 @agentmail.to 域名（付费计划支持自定义域名）
  • MCP 服务器 (npx -y agentmail-mcp) 需要 Node.js (18+)
  • 必须安装 mcp Python 包：pip install mcp
  • 实时 inbound 电子邮件（webhooks）需要公共服务器 — 个人使用建议改为通过 cronjob 轮询 list_threads

验证​

设置完成后，使用以下命令进行测试：

hermes --toolsets mcp -q "Create an AgentMail inbox called test-agent and tell me its email address"

您应该看到返回的新收件箱地址。

参考​