Hermes Gateway、Telegram、Matrix、Discord、Feishu/Lark 等消息平台接入与排错。
Hermes Gateway 中 agent.max_turns 写成 9000，却在长任务心跳里显示 iteration X/90。本文复盘 #19158：为什么旧 .env 里的 HERMES_MAX_ITERATIONS=90 会通过 dotenv reload 覆盖 config.yaml，以及如何排查配置优先级。
Hermes issue #8338 暴露了一个配置优先级反转：display.streaming 本应只控制 CLI 终端显示，却错误覆盖了 Gateway 的 streaming.enabled: false，让 Discord、Telegram 等消息平台开始流式编辑。本文解释根因、影响和修复思路。
Hermes 升级后 Matrix、Telegram、飞书突然报 cannot import name cfg_get？这通常不是平台配置或模型 API 问题，而是 Gateway 仍在运行旧代码/旧 import 状态。本文解释为什么 /reset 无效、gateway restart 有效，以及多 profile/system service 排查方法。
Hermes Telegram 反复提示 Interrupting current task，但 /stop 又说 No active task to stop？这通常是 Gateway adapter._active_sessions 与 runner._running_agents 状态分裂导致的 stale busy lock。本文解释症状、/restart 临时恢复和 #14513 修复方向。
Hermes Telegram Gateway 里 /model 看得到却不生效？本文解释 /model 被移除、CLI 切换不影响 Telegram session、Agent 幻觉式声称已切换，以及如何用日志和 provider 账单验证真实模型。
Hermes Agent 接入飞书 / Lark 后，危险命令审批卡片点击 Allow Once、Session、Always、Deny 报 200340？这通常不是模型 API 问题，而是 Feishu card.action.trigger、Interactive Card 与 Card Request URL 没配置完整。本文给出远程审批回调链路排查清单。
Hermes Agent Matrix bot 能登录、同步旧消息、接受邀请，却完全不回复新消息？这通常不是模型 API 问题，而是 Matrix Gateway 的 sync / receive_response / callback 事件分发链路问题。本文基于真实修复讨论拆解 password login、device_id、initial sync、时间戳过滤和 DeepAI/OpenAI-compatible 分层排查。
基于 Hermes GitHub Issues，总结 Windows 系统代理导致 auxiliary client 502、terminal.backend=local 仍跑 Docker、飞书 Markdown 表格显示源码等跨平台问题，帮助区分 DeepAI 模型层和 Hermes 运行环境层。
从 Hermes Agent GitHub Issues 看三类高频误判：Discord 重复回复、Custom Provider Cloudflare 403、长任务 heartbeat 异常。本文按链路分层排错，帮助判断问题在平台、Gateway、Agent 还是上游模型。