Hermes Agent Gateway Token 和 Chat ID 怎么配置：Telegram、飞书、企业微信

Token 只是第一层

Gateway 不回复时，很多人只盯着 Bot Token。实际上要同时确认五件事：Token 有效、回调地址可达、允许名单正确、Chat ID 正确、后台进程加载的是最新配置。

最小检查顺序

hermes config check
hermes doctor
hermes gateway status

如果有后台进程，先看最近日志。没有日志就用前台方式启动一次，让错误直接显示出来。

Chat ID 不要靠猜

Telegram、飞书、企业微信的个人聊天、群聊、频道、机器人回调 ID 都可能不同。先在一个测试群里发送最短命令，例如 `/status` 或一句短问答，确认消息能进入 Hermes，再跑日报或长工作流。

允许名单和权限边界

团队群里尤其要确认谁能触发任务。建议第一阶段只允许可信用户触发只读任务；涉及外发、写入、删除、部署的动作必须保留人工确认。

修改配置后要重启

如果 Token、Chat ID 或允许名单改过，但 Gateway 仍然不回复，优先重启 Gateway 进程。很多问题不是配置没改，而是后台进程没重新读取。

验证 Chat ID 的最短路径：发一条 send

Token 和 Chat ID 到底配没配对，不必等机器人开口说话才知道。`hermes send` 不经过 LLM，直接拿 `~/.hermes/.env` 和 `~/.hermes/config.yaml` 里的凭证把文本推出去，Telegram 这种 bot-token 平台甚至不需要 gateway 进程开着：

hermes send --to telegram:123456789 "id check"
hermes send --list telegram

第一条发出去、群里收到了，说明 Token 和 Chat ID 这一层全部正确，剩下的毛病只可能出在 gateway 进程或会话链路上；发不出去，问题就锁死在凭证或 ID 本身，这时重启多少遍 gateway 都是无用功。这一刀把排查范围直接砍掉一半。拿不准 ID 的时候先跑第二条，`--list` 列出该平台所有可用目标，从输出里照抄，比从平台页面里抠数字再手敲可靠。抄的时候留意符号：群聊 ID 经常是 -100 开头的一长串负数，负号是 ID 的一部分，漏抄负号是这类配置里最隐蔽的错。建议把这条 send 变成固定动作：以后每换一个群、每建一个新频道，都先发一条试探，通了才把 ID 写进配置。

两个文件各管一摊：.env 放秘密，config.yaml 放行为

很多配置混乱源于把两个文件当成一个用。`~/.hermes/.env` 是环境变量文件，Bot Token、API Key 这类秘密值归它；`~/.hermes/config.yaml` 是结构化配置，平台、目标、行为开关归它。改 Token 就去 .env，改投递目标就去 config.yaml，方向反了一定出乱子。这样分还有个排查上的好处：让别人帮忙看配置时，把 config.yaml 内容发出去不会顺手泄露任何密钥，秘密值始终只待在 .env 一处。找不到文件实际在哪，问命令最快：

hermes config env-path
hermes config path
hermes config show

前两条分别输出 .env 和 config.yaml 的真实路径，第三条打印当前生效的配置。改完 config.yaml 先跑一次 `config show`，看到新值才去平台里发消息，能省掉一大半"到底是没改对还是没读到"的来回猜测。两节合起来，这篇文章的排查顺序就能固定下来：send 验证凭证层，show 验证配置层，两层都确认无误，剩下的嫌疑才轮到 gateway 进程，按这个次序走基本不会白忙。

还没有真实场景？可以先领取 [Free Starter 模板包](/free-template-pack)，从低风险只读任务开始试跑。