Telegram Bot 无回复排查 SOP:从网关到限流到记忆
这是过去一个月 171 个运维会话里出现频率最高的故障(约占 1/4)。修一次,写成 SOP,后人不再踩。
排查顺序(别跳步)
- 网关活着吗:
systemctl status看 Bot 网关进程,有没有死、有没有在重启循环。 - 限流了吗:查日志
rate-limit / 429,撞限流先降频、排队,别急着重启。 - 鉴权过期了吗:token / API key 是否过期或被轮换,重新签发后更新配置。
- 模型过期了吗:上游模型下线或改名会导致静默失败,切可用模型验证。
- 记忆层坏了吗:跨会话记忆(如 Honcho)迁移/损坏时,Bot 常表现为“收到但不回”,清空或重建记忆再测。
为什么值得写成 SOP
单次排查平均烧掉半小时,全是重复劳动。五步走完仍无解,再开新会话深挖;五步内解决的,直接记一条日志,不占用长会话。
待补
gateway service 与 bot binding 的完整检查清单(含各配置文件位置),补完后升级为铁律级文档。