别再一个平台养一个 Bot,Hermes 三平台接入一个下午搞定
这套 Hermes 在我服务器上跑了两个月,微信和 Discord 双平台在线,日均五十多条消息,没掉过链子。前两天重装环境,从零再接一遍,发现当初踩过的坑一个都没记住,全靠翻笔记才没摔第二次。索性把这次重接的过程写成清单,从空环境到 Telegram、Discord、微信三平台同时在线,一个下午足够。坑在哪、怎么绕,一次说清。
老雷先给个总原则,给 Agent 接消息平台,最忌讳每换一个平台就养一个 Bot 进程。进程一多,密钥、日志、上下文全散掉,运维成本翻着倍涨。Hermes 的网关是单个长驻进程管所有平台,v0.16.0 官方支持 22 个,你只需要维护一份 .env。
二十二个平台,先把矩阵看清楚
平台清单拉开很长,Telegram、Discord、Slack、WhatsApp、Signal、微信、企业微信、飞书、钉钉、QQ、Google Chat、Teams、Matrix、LINE、Email,从国际主流到国内五大全部原生覆盖。国内五大不靠第三方桥接直接接,这在国际开源项目里极少见,也是我当初选它而不是 CowAgent 的直接原因。
矩阵里几个细节值得单独拎出来。飞书是能力最全的平台之一,语音、图片、文件、线程、表情、流式更新全支持,和 Discord 同一等级,团队用飞书办公的可以放心上。SMS 走 Twilio 只能纯文本,ntfy 是单向推送不能对话,这俩是保底通道,IM 全挂的时候至少还能收到通知。BlueBubbles 和 Home Assistant 挂着实验性标签,生产别碰。社区非官方文档已经记到 25 个以上适配器,还有个 Rust 重写版实现了其中 17 个,单二进制部署,适合小内存 VPS,不过能力矩阵还是以官方 Python 版为准。
架构一句话讲完。GatewayRunner 一个进程,每个平台一个适配器,消息进来先落进按聊天维度拆的会话存储,再分派给 Agent 核心,回复原路返回。适配器源码全在 gateway/platforms/ 目录,一个平台一个 Python 文件。你要做的只有两件事,改 .env 和 config.yaml,一行代码不用写。
三站接入,一站一个坑
Telegram 是最顺的一站。找 @BotFather 发 /newbot,起个显示名,再起一个全 Telegram 唯一、必须以 bot 结尾的用户名,拿到形如 123456789:ABCdef 的 Token,填进 .env 的 TELEGRAMTOKEN,hermes gateway start,五分钟内你在自己的 Bot 页面发消息就能收到回复。两个可选项建议都配上,TELEGRAMALLOWEDUSERS 限定谁能用,TELEGRAMHOME_CHANNEL 指定默认活跃频道。Telegram 的好处是零审核、零成本、毫秒级延迟。唯一的暗坑是 getUpdates 长轮询排他,一个 Token 只允许一个客户端在轮询,旧服务没杀干净,消息就会时有时无。
Discord 比 Telegram 多一步,坑也在这。Developer Portal 建 Application,开 Bot,拿 Token,然后是全流程最容易翻车的地方,Bot 页面往下滚,把 Privileged Gateway Intents 三个开关全打开,尤其 Message Content Intent。这个开关不开,Bot 看得到有人发消息,却读不到内容,回复永远是「我无法理解你说什么」。我第一次接就在这卡了半个多小时,日志里没有任何报错,就是读不到字。往后走,OAuth2 的 URL Generator 勾上 bot 权限生成邀请链接拉进服务器,.env 里填 DISCORDBOTTOKEN 和 DISCORDALLOWEDUSERS,注意要纯数字用户 ID,不是用户名,开发者模式打开后右键头像就能复制。行为开关三个按需设,requiremention 设 true 就只响应 @提及,autothread 自动建线程,reactions 控制处理中的表情回应。config.yaml 里还有两处值得花两分钟,ignoredchannels 列表把语音频道这类不需要 Bot 的地方排除掉,channelprompts 字典按频道 ID 给每个频道写一段职责说明,Agent 进了频道就知道自己该干什么,这个设计后面做分区运营时会非常好用。
微信这站最值得展开,因为微信生态的自动化方案鱼龙混杂,封号风险是实打实的。Hermes 用的是腾讯官方的 iLink Bot 协议,不是公众号 API,不是企业微信,更不是 wxhook、itchat 那类逆向破解。基座地址 ilinkai.weixin.qq.com,二维码扫码登录,35 秒长轮询收消息,每条消息绑一个 context_token,回复时必须原样回传。接入简单到离谱,hermes gateway setup 里选 Weixin,终端出二维码,微信扫码确认,Token 自动写进 .env,前后两分钟。能力上文字、图片、视频、文件、语音全支持,文字超 4000 字符自动分段,收到的语音自动转写。代价也摆在明面上,Bot 身份进不了普通微信群,只做一对一私聊,这是协议的硬限制。但它是目前唯一零封号风险的微信自动化方案,生产环境没有第二个合规选项。比它功能强的 wechatferry 是逆向协议,群聊能进,封号风险也真实存在,老雷的建议是个人玩玩随你,公司业务别碰逆向。
微信的私聊策略单独说一句,.env 里 WEIXINDMPOLICY 给两个值,默认 pairing,陌生人发消息要配对批准才放行,个人用优先这个。公开服务场景才设 open,所有人可以直接私聊。配对在终端里管,hermes pairing list 看待批列表,approve 加配对码放行,revoke 随时收回。我的习惯是新号先 pairing 跑一周,稳定了再考虑放开。
三站各自通了之后,把配置并进 ~/.hermes/.env 一个文件,hermes gateway start 一条命令全平台上线。会话重置策略建议按平台分开设,config.yaml 里 resetbyplatform 这一段,Telegram 给 240 分钟,碎片化对话经得起放。Discord 给 60 分钟,频道节奏快。微信给 1440 分钟,私聊上下文保持一整天比较自然。

会话是隔离的,记忆是共享的
有个认知要先对齐。默认情况下,每个平台的每个聊天窗口都是独立会话,你在 Telegram 里聊了一半,切到 Discord 它并不知道。很多人当成 Bug 来报,其实是设计,上下文不串台反而干净。
真正跨平台共享的是三层文件。SOUL.md 定身份和行为准则,所有平台都读得到。MEMORY.md 存事实和偏好,你告诉过它的事全平台记得。USER.md 是用户画像。再配上 SQLite 的全文检索,历史会话随时能翻旧账。想让某个事实跨平台生效,让它写进 MEMORY.md 就行。
我的做法再往前一步,指针架构。三层文件里只写两类内容,行为约束,以及知识库在哪、怎么导航。所有事实性内容让它在对话里现场 read_file 去读。好处是零维护,我在 Claude Code 里改了知识库,Hermes 下次对话自动感知,系统里永远不会有第二份真值。
上线前堵住这六个坑
下面六条,每条都花过我半小时以上,抄进交付 checklist 里。
双 Bot 抢答。Discord 服务器里同时跑着 Hermes 和另一个 AI Bot 时,每条消息两边都抢着回。只留一个主动响应的,其余全部 require_mention 设 true,或者干脆分频道隔离。
Telegram Token 被抢。升级 Hermes 后旧的 service 单元没清掉,两个进程抢同一个 Token,症状是消息时有时无。新版安装器会自动检测移除,手动装过的自己确认进程唯一。
Discord 表格不渲染。Markdown 表格在 Discord 里显示成纯文本。我手写了个小渲染器绕过去,检测到表格就转成白底 PNG 当附件发。
微信登录态过期。iLink 的登录态不是永久的,过期后 Hermes 不报错,只是消息不再到达。适配器显示 running 却很久没有消息活动,大概率就是它,重新跑一遍扫码绑定就好,日常记得定期看 gateway status。
压缩风暴。上下文压缩任务默认跟着主模型走,主模型限流时压缩跟着挂,Agent 会丢掉整段对话上下文。给 auxiliary.compression 显式配一个独立 Provider,主备必须分家,老雷把这条当部署红线。
工具 Schema 吃 token。72 个内置工具的完整定义约 19210 token,每次对话都加载。打开 tool_search 之后只保留高频工具的完整定义,其余按需查找,实测降到 2200 上下,省了 89%。
演示环境跑通不算交付。上线那天出的幺蛾子全在教程之外,提前堵住才叫上线。

横着比一比再定方案
同类开源方案里值得对比的是两个。CowAgent,前身 chatgpt-on-wechat,45K Stars,微信生态里最有名,支持 7 个平台,但 Telegram、Discord、Slack、WhatsApp 一个都没有,用户在国际平台就直接出局,微信侧走 wechatferry 逆向协议,群聊能进,风险自担。LobsterAI,网易有道出品,5K Stars,10 个平台,Telegram 和 Discord 都有,但它是 Electron 桌面应用,必须跑在带图形界面的机器上,做不到 7×24 挂在无头服务器,这对消息助手是硬伤。
还有一个容易被忽略的差异,Hermes 支持 hermes mcp serve 起反向 MCP 服务,暴露十个工具,Claude Code 和 Codex 跑完长任务能主动调它把结果推到你手机。CowAgent 和 LobsterAI 都没有这个能力。如果你的工作流是 AI 编程工具干完活自动通知,这一条就够定夺了。
没有服务器的还有个偷懒选项,社区维护的 Railway 一键部署模板,网页面板里配好模型 Key、勾选 Telegram、贴上 Token 就能跑,零运维。代价是成本比自己的 VPS 高,微信扫码在网页终端里体验一般。真上生产,我还是建议 Docker 部署到自己的 VPS,数据持久化也省心。
平台是入口,Agent 是本体。入口可以一天换一个,本体养好了才是资产。
这篇的清单当天就能执行,第一步是花五分钟把 Telegram 那站跑通,看到 Bot 回你第一句话,后面两站都是水到渠成的事。
