毓惶博客

本文是 Hermes Agent 教学系列 第 04 篇。把 Hermes 从终端里补出来,装到手机上。

为什么要接消息平台

CLI 不是不能用,是不够用。你总不能一整天坐在 SSH 终端前面。接上消息平台后:

去洗手间的路上用 Telegram 给它发一句「帮我总结今天的 Slack 重点」,走出二楼手上就收到

agent 跑在云端 VPS 上,你从未 SSH 过去也能控制

多设备同步,手机、电脑、平板都是同一个 agent

这个跨平台打通是 Hermes 跟 Claude Code、OpenClaw 这类纯本地 agent 拉开距离的部分。

Gateway:一个进程接所有平台

Hermes 的设计是 单 gateway 多适配器。你不需要为每个平台起一个进程,所有平台指向同一个 Hermes。

在 Telegram 发的消息、在 Discord 发的消息,Hermes 都能跨平台理解上下文。

接入 Telegram(推荐从这个开始)

Telegram 是所有平台里最好接的,三分钟搞定。

步骤 1:创建 Telegram bot

打开 Telegram,搜索 @BotFather

发送 /newbot

给 bot 取个名字(如「My Hermes」)

取个唯一的 username(必须 _bot 结尾,如 myhermes_bot)

BotFather 会给你一串 token,形如 123456:ABC-DEF...,复制保存

步骤 2:告诉 Hermes

按提示粘贴 token。Hermes 会问你:

哪些用户可以跟 bot 对话? —— 重要!一定要填你自己的 Telegram user ID 或 username,否则任何人发现你这个 bot 都能免费调用你的模型额度

要不要启动该 gateway? —— 选 Yes

获取自己的 Telegram user ID:发一句话给 @userinfobot。

步骤 3:试试

回到你刚建的 Hermes bot,发:

几秒后会收到回复。现在 CLI 里跟手机上聊的是同一个 Hermes,上下文互通。

接入 Discord

适合拿来做团队共享助手。

步骤 1:在 Discord 开发者门户建应用

打开 Discord Developer Portal

New Application → 起名

左侧 Bot 菜单 → Add Bot → 拷 token

OAuth2 → URL Generator 里勾选 bot + 需要的权限(最少 Send Messages 和 Read Message History)

贴生成的 URL 到浏览器,邀请 bot 进你的服务器

步骤 2:接入 Hermes

同样会问 token 和授权用户/频道。建议在小服务器里开个专用频道叫 #hermes,别让它潫到众频道里。

接入 Slack

适合公司场景,但公司 Slack 一般要 admin 批准。步骤:

api.slack.com/apps 创建 app

OAuth & Permissions 里添加 scopes(chat:write, app_mentions:read, im:history, im:write)

Install to Workspace → 拿到 Bot Token(以 xoxb- 开头)

Event Subscriptions 里打开,订阅 app_mention 和 message.im

企业 Slack 的特别提醒:Slack 请求是从他们服务器发过来的,你的 Hermes 需要一个公网可达的 URL。本机调试可以用 Hermes 内置的 ngrok 隧道(hermes gateway add slack --tunnel)。

接入 WhatsApp / Signal / 邮件 / SMS

这些平台接法都类似,hermes gateway add <name> 走向导。但重点不同:

WhatsApp:需要 Meta WhatsApp Business API 账号,或走社区的 BlueBubbles 桥

Signal:需要 signal-cli,要为 Hermes 独立注册一个号码

邮件:提供 SMTP/IMAP 账号即可。变相于让 Hermes 能发邮件,你发邮件他也能回

SMS:接 Twilio 之类的营运商,有费用

钉钉 / 飞书 / 企业微信

国内用户会比较在乎这几个,都在支持列表里。每个的接入都需要该平台的 webhook 或 bot 凭证:

钉钉:创建自定义机器人,拿 Webhook URL

飞书:在飞书开放平台创建企业自建应用,拿 App ID + Secret

企业微信:同样是企业自建应用流程

测试方式:在对应平台里跟 bot 对话,能收到回复就是通了。

多上下文隔离与统一

默认行为:

同一个用户在 Telegram 跟 Discord 中发的消息共享上下文和记忆

不同用户互相隔离,Hermes 会为每个用户维护独立的用户模型

如果你想让不同平台上的聊天互相隔离(比如 Slack 是公司事、Telegram 是个人事),可以在配置里开:

运维必看:后台运行

CLI 里 hermes 是交互式,一关终端 gateway 就停。要让它 24/7:

macOS 用 launchctl,文档里 hermes service install --platform darwin。

看日志:

agent 现在会说话了,但它为什么说「会成长」?下一篇拆解它的记忆系统——FTS5 全文检索、LLM 摘要、跨会话召回,以及你怎么手动管理这块记忆。

本系列文章持续更新,下篇见。

Menu