多平台网关 · Hermes Agent 橙皮书

一、为什么"多平台"是 Hermes 的核心优势

回想一下你一天用了多少个 App：

早上：iOS 闹钟、微信
通勤：Telegram、抖音
上班：Slack / 企业微信 / 飞书、邮箱、Notion
中午：美团、点评
下午：开会用腾讯会议
晚上：iMessage 给家里人发消息
睡前：Telegram 看几个频道

如果 AI 助手只活在某一个 App 里，你就要不停在 App 之间切换。

Hermes 把这件事彻底解决了。它支持 7 种主流消息平台 + 多种 IDE + 语音模式，而且：

✅ 同一份记忆（你早上跟它说的话，下午在 Slack 里它都记得）
✅ 同一组 Skill（你在终端里学会的 Skill，在手机上也能调）
✅ 同一份人格（SOUL.md 全平台生效）

这就是"无处不在的它"。

二、Hermes Gateway 总览

平台	难度	国内可用	推荐场景
Telegram	⭐	需代理	个人移动端首选
Discord	⭐	需代理	社区/团队
Slack	⭐⭐	需代理	海外公司
WhatsApp	⭐⭐⭐	需代理	海外联系人
Signal	⭐⭐	需代理	隐私敏感
Email	⭐	✅	跨人/跨公司协作
iMessage	⭐⭐	✅（Mac）	苹果生态家人
企业微信桥	⭐⭐⭐	✅	国内公司
飞书桥	⭐⭐⭐	✅	国内公司
微信桥	⭐⭐⭐⭐	✅	个人/家人
VS Code (ACP)	⭐⭐	✅	写代码
JetBrains (ACP)	⭐⭐	✅	写代码
Zed (ACP)	⭐	✅	写代码
语音模式	⭐⭐	✅	开车/做饭/没空打字

下面我们按"使用频率"从高到低，挑最有价值的几个详细讲。

三、最重要：Telegram（个人移动端首选）

3.1 为什么先讲 Telegram

是 2026 年最好用的 IM 之一，机器人生态最完善
支持文字、语音、图片、文件，全功能输入
可以自动加 Hermes 到任何对话里
国内只要有梯子，连接稳定

3.2 创建一个 Telegram Bot

在 Telegram 里搜 @BotFather，开始对话
发 /newbot
给你的 Bot 起个名字（比如 "MyHermes"）和用户名（必须 _bot 结尾，比如 my_hermes_bot）
BotFather 会给你一个 Token，长这样：6789012345:AAH1234567890abcdefghijklmnopqrstuvw
复制这个 Token，下一步要用

3.3 配 Hermes

hermes config set TELEGRAM_BOT_TOKEN 6789012345:AAH1234567890abcdefghijklmnopqrstuvw

hermes gateway setup telegram

3.4 限制只允许你访问（重要！）

如果不限制，任何人只要知道你的 Bot 用户名都能跟它聊，烧的是你的 API 钱。

获取你自己的 Telegram User ID：

在 Telegram 里搜 @userinfobot，发 /start
它会告诉你你的 ID（一串数字）

加到配置：

hermes gateway config telegram --allowed-users 你的TGID,你老婆的TGID

或在 ~/.hermes/gateway.yaml 里：

telegram:
  bot_token_env: TELEGRAM_BOT_TOKEN
  allowed_users:
    - 123456789       # 我
    - 234567890       # 老婆
  rate_limit:
    per_user: 30/h    # 防止误操作刷爆

3.5 启动

hermes gateway start telegram

或者一次启动所有已配置网关：

hermes gateway start --all

3.6 第一次使用

打开 Telegram，搜你刚创建的 Bot（比如 @my_hermes_bot），点 Start。

发送任何消息，Hermes 都会回复。所有第六、七章学到的东西，现在都能在手机上用了。

试一下：

你：今天有什么待办？
Hermes：根据你的 Apple Calendar 和 Things，今天有 3 件事：
  1. 10:00 产品评审会
  2. 14:30 给客户 ACME 回方案
  3. 18:00 健身（按你给自己定的目标）
  
  另外昨晚我注意到你的支付宝有一笔 ¥200 的扣款标记为"未知商户"，要不要看一下？

你：[发个 90 分钟会议录音]
Hermes：收到。已开始处理 meeting-notes-from-audio... 大约 4 分钟后会发纪要给你。

你：[发个抖音链接]
Hermes：这是个英语学习视频。要我整理成笔记吗？

3.7 进阶：Telegram 也能跑工作流

你在 Telegram 里说："每天早 7 点把昨天的邮件汇总发到这里"——Hermes 会自动创建一个 cron 任务，从此每天 07:00 你的 Telegram 都会收到邮件简报。

四、Discord（团队/社区）

4.1 创建 Discord 应用

打开 discord.com/developers/applications
New Application，给个名字
左侧 Bot → Add Bot → 复制 Token
左侧 OAuth2 → URL Generator → 勾选 bot、applications.commands → 在 Bot Permissions 里选你需要的权限（普通使用勾 Send Messages、Read Message History）
复制生成的 URL，浏览器打开，把 Bot 邀请到你的服务器

4.2 配 Hermes

hermes config set DISCORD_BOT_TOKEN MTIzNDU2....
hermes gateway setup discord
hermes gateway start discord

4.3 在 Discord 里使用

在频道里 @Bot：@MyHermes 总结一下这个频道今天的讨论
给 Bot 发私信：跟 Telegram 一样的全功能体验

4.4 有用的 Discord 玩法

把 Hermes 加到游戏战队的频道：自动总结昨晚活动战报
加到学习群：自动整理大家发的资料
加到读书会：每月统计大家读了什么

五、Slack（公司内部）

5.1 创建 Slack App

打开 api.slack.com/apps
Create New App → From scratch → 命名 + 选 workspace
OAuth & Permissions → 给 Bot 加这些权限：
- channels:history channels:read chat:write im:history im:read users:read
Install to Workspace → 复制 Bot User OAuth Token（以 xoxb- 开头）
（可选）Socket Mode → 启用 → 复制 App-Level Token（以 xapp- 开头），可以避免暴露公网

5.2 配 Hermes

hermes config set SLACK_BOT_TOKEN xoxb-xxxxxxxxx
hermes config set SLACK_APP_TOKEN xapp-xxxxxxxxx       # 可选，用 Socket Mode

hermes gateway setup slack
hermes gateway start slack

5.3 玩法

DM Bot：完全私密，把它当个人助理
在频道里 @Bot：让它公开做事，比如"@MyHermes 把这个讨论整理成需求文档"
Slash 命令：在 Slack 里输入 /hermes 总结今天 #engineering 频道的所有 PR，1 秒响应

六、企业微信桥 / 飞书桥（国内公司必备）

国内公司大多用企业微信或飞书。Hermes 官方还没原生支持，但社区有非常成熟的桥接方案。

6.1 思路

桥接的本质：用一个开源项目当"翻译器"，把企业微信/飞书的消息格式转成 Hermes 能理解的格式（一般是 OpenAI 兼容的 webhook）。

主流桥接项目：

项目	适用平台	部署难度
`wechaty` 系列	微信、企业微信	⭐⭐⭐
`lark-mcp`	飞书	⭐⭐
`wecom-bot-svc`	企业微信群机器人	⭐⭐
`nonebot2 + cqhttp`	QQ、微信、飞书	⭐⭐⭐

6.2 企业微信群机器人（最简单）

如果你只需要"把 Hermes 的输出推到企业微信群"：

在企业微信群里：群设置 → 群机器人 → 添加机器人 → 复制 Webhook 地址
在 ~/.hermes/notify.yaml 里加：

channels:
  - name: wecom-team
    type: webhook
    url: "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxxxx"
    format: wecom-markdown

在 cron 任务里指定推送到这个 channel：

hermes schedule "每周五 17:00 跑 weekly-report，结果推到 wecom-team"

每周五下午，团队群里就会自动出现你的周报。

6.3 飞书机器人（自定义机器人）

类似企业微信：

飞书群 → 设置 → 机器人 → 添加 → 自定义机器人 → 复制 Webhook
配置：

channels:
  - name: lark-team
    type: webhook
    url: "https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxx"
    format: lark-card

6.4 真双向（用 wechaty）

如果你想要真正的"双向 + 主动接收消息"，需要部署一个 wechaty 桥：

# 用 Docker 跑（推荐，不污染环境）
docker run -d --name wechaty-bridge \
  -e WECHATY_PUPPET=wechaty-puppet-padlocal \
  -e WECHATY_PUPPET_PADLOCAL_TOKEN=你的token \
  -e WECHATY_TOKEN=自定义token \
  -e WECHATY_CHATBOT_PROVIDER_OPENAI_API_KEY=hermes-bridge-key \
  -e WECHATY_CHATBOT_PROVIDER_BASE_URL=http://localhost:9100/v1 \
  -p 8788:8788 \
  wechaty/wechaty:latest

# 然后在 Hermes 里启动一个 OpenAI 兼容的服务，wechaty 会把消息打过来
hermes serve openai-compat --port 9100

注意：用桥接的方式接微信账号有被官方封号的风险（轻微风险）。建议：

用小号
不要发广告/营销
频率不要太高
给爸妈用最好用企业微信而不是个人微信

七、邮件 Gateway（最稳定的跨人协作）

邮件是最古老但最可靠的跨人协作方式。Hermes 接邮件之后能：

你给某邮箱地址发邮件 → Hermes 收到，处理后回复你
你给团队成员发邮件 → 抄送 Hermes，让 Hermes 自动整理 / 提醒 / 备份

7.1 配置

# ~/.hermes/gateway.yaml
email:
  smtp:
    host: smtp.gmail.com
    port: 587
    user: your-hermes-bot@gmail.com
    password_env: HERMES_BOT_EMAIL_PASS
  imap:
    host: imap.gmail.com
    port: 993
    user: your-hermes-bot@gmail.com
    password_env: HERMES_BOT_EMAIL_PASS
  
  triggers:
    # 收到主题以"@hermes"开头的邮件就处理
    - subject_starts_with: "@hermes"
    # 收到来自指定地址的所有邮件
    - from_in: ["me@example.com", "wife@example.com"]
  
  reply_format: "html"

7.2 用法

发邮件给 your-hermes-bot@gmail.com：

主题：@hermes 客户 ACME 合同审核

正文：
请帮我审一下附件的合同。重点看：
1. 付款条款是否符合我们标准
2. 违约责任是否对等
3. 知识产权归属

把发现的问题整理成表格回我邮件。

附件：合同v3.docx

5~10 分钟后，你会收到 Hermes 的回信，正文里有完整的审核报告。

八、IDE 集成：写代码时叫 Hermes

如果你写代码，Hermes 通过 ACP（Agent Communication Protocol）能直接挂到 VS Code、JetBrains、Zed 里。

8.1 启动 ACP 服务

hermes acp start --port 9123

8.2 VS Code

装扩展：搜 "Agent Communication Protocol" 安装
配置 → 新建 ACP backend → 名字 "Hermes"，URL http://localhost:9123
在编辑器右侧侧栏选 Hermes → 开始对话

效果：你在写代码，旁边一直挂着 Hermes，所有项目上下文（文件、Git、错误）它都能看到。问"为什么这段会报错"它能直接给修复 PR。

8.3 JetBrains（IntelliJ / PyCharm / GoLand）

类似流程，装一个 ACP 插件，配 backend。

8.4 Zed（推荐）

Zed 编辑器原生支持 ACP，配置最简单：

// ~/.config/zed/settings.json
{
  "agent": {
    "provider": "acp",
    "endpoint": "http://localhost:9123"
  }
}

启动 Zed，按 Cmd + ?，Hermes 就在你旁边了。

8.5 IDE 集成有什么不同

主要是上下文自动注入。当你在 IDE 里问 "为什么 user.py 的 login 函数会失败"，Hermes 自动知道：

当前 cursor 在哪里
当前打开的文件
整个项目结构
最近的 git diff
终端里最后的 error 输出

不用你贴任何代码。

九、语音模式：开车 / 做饭 / 散步时用

9.1 启动

hermes --voice

或在交互里：

> /voice on

启动后，Hermes 会监听你的麦克风。说话即识别，识别后即处理，结果直接读出来。

9.2 推荐场景

开车：到公司前问"今天什么安排？" / 走的时候问"明天安排发个语音给我"
做饭：让 Hermes 念食谱步骤
散步：处理那些"想了好久没空写"的事
健身：让它念书的内容给你听
躺床上：复盘一天

9.3 在 Telegram / Discord 里也能用语音

直接发语音消息给 Bot——Hermes 会自动转写、处理、再用语音回复。

十、跨平台一致性：同一个它

我们再强调一次，因为这是 Hermes 的杀手特性：

                ┌───────────────────────┐
                │   Hermes Core         │
                │   (一份记忆、一份 Skill) │
                └───────────┬───────────┘
                            │
       ┌─────────┬──────────┼──────────┬─────────┐
       ↓         ↓          ↓          ↓         ↓
   ┌──────┐ ┌──────┐  ┌─────────┐ ┌────────┐ ┌──────┐
   │ CLI  │ │ TG   │  │ Slack   │ │ Email  │ │ IDE  │
   └──────┘ └──────┘  └─────────┘ └────────┘ └──────┘

   你在 IDE 里调过的 Skill，下午在 Telegram 里能立刻用
   你在 Slack 里教过它的偏好，晚上在终端里它依然记得

这就是"会成长的伙伴"的物理基础。

十一、安全提示

把 Hermes 接到外部 IM/邮件，等于把"控制你电脑的 AI"暴露在了网络上。请遵守：

永远启用 allowed_users——只允许你和家人/团队访问
API Key 不要写到 GitHub——用环境变量，并把 ~/.hermes/.env 加到 .gitignore
高危操作（删文件、付款）必须二次确认
Bot Token 泄露后立即 revoke 重新生成
不要在公开频道里讨论你的 SOUL.md（它包含你的偏好、家人信息）

更多安全实践见第十一章。

本章一图回顾

┌──────── Hermes 的"无处不在" ────────┐
│                                      │
│   早上：智能音箱（语音）             │
│   通勤：Telegram                     │
│   办公：Slack / 企业微信桥           │
│   写代码：VS Code / Zed (ACP)        │
│   会议：Bot 自动加入做纪要           │
│   家人：iMessage / 微信桥            │
│   睡前：Telegram                     │
│                                      │
│   全部共享：                         │
│     · 同一份记忆                     │
│     · 同一组 Skill                   │
│     · 同一份人格 SOUL                │
│     · 同一笔预算                     │
└──────────────────────────────────────┘

下章预告

到这里你的 Hermes 已经"无处不在"了。但所有任务都让一个 Hermes 处理，遇到复杂活会很慢。第十章子代理与 AI 小团队会教你：

怎么让一个主 Hermes 拆任务给多个"小弟" Hermes 并行干
6 种执行后端怎么选
怎么把 Hermes 部署到 5 美元/月的小服务器上 24 小时打工
一个真实的"AI 小团队"配置范例