消息平台
Hermes Agent Gateway 不回复:Telegram、飞书、企业微信排查清单
消息平台已经配置但 Agent 不回复时,按 Token、允许用户、Chat ID、进程日志和模型调用逐项定位。
2026-05-089 分钟阅读GatewayTelegram企业微信排错
先分清两类问题
Gateway 不回复通常分两类:消息没有进入 Hermes,或者 Hermes 收到了消息但模型调用失败。前者看平台配置和权限,后者看进程日志和模型 Provider。
平台侧检查
- Bot Token 或 Webhook 是否仍然有效。
- 发送消息的用户或群是否在允许列表里。
- Chat ID、群 ID、频道 ID 是否填对。
- 企业微信或飞书是否把机器人加入了正确群聊。
- 平台是否需要重新保存回调地址或签名密钥。
Hermes 侧检查
hermes config check
hermes doctor
hermes gateway status如果有后台进程,先看最近 50 行日志。没有日志时,不要继续猜,先让 Gateway 以可见方式启动一次。
模型侧检查
如果平台能收到命令但一直没有最终输出,常见原因是 API Key 失效、模型限流、上下文过长或工作流卡在工具调用。先用 CLI 跑同样输入,确认模型和工作流本身能完成。
最小复现
先只测试 `/status` 或最短问答,再测试日报工作流。不要一开始就测试长报告、文件读取和外部 API,这会把排查面扩大。
下一步
如果你还没有真实场景,可以先领取 Free Starter 模板包,从每日简报、Issue 分类和内容选题三个低风险任务开始。