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 进程。很多问题不是配置没改,而是后台进程没重新读取。
下一步
如果你还没有真实场景,可以先领取 Free Starter 模板包,从每日简报、Issue 分类和内容选题三个低风险任务开始。
常见问题
把搜索里最常见的疑问集中放在这里,适合排查时快速确认方向。
Gateway Token 配好后为什么还是不回复?+
Token 只是入口之一,还要确认发送者是否在允许名单里、Chat ID 是否正确、机器人是否在目标群里,以及 Gateway 进程是否加载了最新配置。
Chat ID 和群 ID 容易错在哪里?+
常见错误是把个人聊天、群聊、频道或测试群 ID 混用。先在一个测试窗口跑 /status,再接真实工作流。
要不要直接接正式群?+
不建议。先接测试群,确认权限、日志和人工确认流程都稳定,再进入正式频道。