Hermes-agent

2026-06-14 14:30:48 -04:00
commit dac4b88b94
5058 changed files with 1884848 additions and 0 deletions
@@ -0,0 +1,143 @@
+---
+title: "Agentmail — 通过 AgentMail 为 Agent 提供专属电子邮件收件箱"
+sidebar_label: "Agentmail"
+description: "通过 AgentMail 为 Agent 提供专属电子邮件收件箱"
+---
+
+{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
+
+# Agentmail
+
+通过 AgentMail 为 Agent 提供专属电子邮件收件箱。使用 Agent 专属电子邮件地址（例如 hermes-agent@agentmail.to）自主发送、接收和管理电子邮件。
+
+## Skill 元数据
+
+| | |
+|---|---|
+| 来源 | 可选 — 使用 `hermes skills install official/email/agentmail` 安装 |
+| 路径 | `optional-skills/email/agentmail` |
+| 版本 | `1.0.0` |
+| 平台 | linux, macos, windows |
+| 标签 | `email`, `communication`, `agentmail`, `mcp` |
+
+## 参考：完整 SKILL.md
+
+:::info
+以下是 Hermes 在触发此 skill 时加载的完整 skill 定义。这是 skill 激活时 Agent 所看到的指令内容。
+:::
+
+# AgentMail — Agent 专属电子邮件收件箱
+
+## 前置要求
+
+- **AgentMail API 密钥**（必需）— 在 https://console.agentmail.to 注册（免费套餐：3 个收件箱，每月 3,000 封邮件；付费套餐起价 $20/月）
+- Node.js 18+（用于 MCP 服务器）
+
+## 使用场景
+在以下情况下使用此 skill：
+- 为 Agent 提供专属电子邮件地址
+- 代表 Agent 自主发送电子邮件
+- 接收并读取传入邮件
+- 管理邮件线程和对话
+- 通过电子邮件注册服务或进行身份验证
+- 通过电子邮件与其他 Agent 或人类进行通信
+
+此 skill **不适用于**读取用户的个人邮件（请使用 himalaya 或 Gmail）。
+AgentMail 为 Agent 提供独立的身份和收件箱。
+
+## 配置
+
+### 1. 获取 API 密钥
+- 访问 https://console.agentmail.to
+- 创建账户并生成 API 密钥（以 `am_` 开头）
+
+### 2. 配置 MCP 服务器
+添加至 `~/.hermes/config.yaml`（粘贴实际密钥 — MCP 环境变量不会从 .env 展开）：
+```yaml
+mcp_servers:
+  agentmail:
+    command: "npx"
+    args: ["-y", "agentmail-mcp"]
+    env:
+      AGENTMAIL_API_KEY: "am_your_key_here"
+```
+
+### 3. 重启 Hermes
+```bash
+hermes
+```
+所有 11 个 AgentMail 工具现已自动可用。
+
+## 可用工具（通过 MCP）
+
+| 工具 | 描述 |
+|------|-------------|
+| `list_inboxes` | 列出所有 Agent 收件箱 |
+| `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`）
+   - 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 读取验证码
+```
+
+**Agent 对人类的外发联系：**
+```
+1. create_inbox (username: "hermes-outreach")
+2. send_message (to: user@example.com, subject: "Hello", text: "...")
+3. list_threads 检查回复
+```
+
+## 注意事项
+- 免费套餐限制为 3 个收件箱，每月 3,000 封邮件
+- 免费套餐邮件来自 `@agentmail.to` 域名（付费套餐支持自定义域名）
+- MCP 服务器需要 Node.js（18+）（`npx -y agentmail-mcp`）
+- 必须安装 `mcp` Python 包：`pip install mcp`
+- 实时入站邮件（webhook）需要公网服务器 — 个人使用时建议改用 `list_threads` 轮询配合 cronjob
+
+## 验证
+配置完成后，使用以下命令测试：
+```
+hermes --toolsets mcp -q "Create an AgentMail inbox called test-agent and tell me its email address"
+```
+应返回新收件箱的地址。
+
+## 参考资料
+- AgentMail 文档：https://docs.agentmail.to/
+- AgentMail 控制台：https://console.agentmail.to
+- AgentMail MCP 仓库：https://github.com/agentmail-to/agentmail-mcp
+- 定价：https://www.agentmail.to/pricing