如何自行排查并修复 OpenClaw Telegram 机器人卡死/无响应问题

状况二：机器人有连接，但发指令进去却一直“转圈”卡死

从现有证据来看，这种情况下多半不是 Token 有问题，而是网关的运行时层面出了岔子。
一个高相关度的线索是：有开发者提交了一个 Gateway CPU 空转导致 Telegram 回复被严重卡住的错误报告。如果 CPU 进入死循环，机器人会连上网络，却无法处理任何进来的消息，表现为“看似在线却完全不回应”。

注意： CPU 空转虽然是个很强的嫌疑，但目前它只是一个已知 Issue，并非针对你当前环境下的百分百确诊。请把它视为“高度疑似”，然后结合下方标准诊断流程来验证或排除。

标准诊断顺序（照着做，不要跳步）

1. 先看运行时/网关的生命体征（最重要的一步），不要一上来就改 config。
   • 跑

     openclaw status

     这类命令，紧盯两样东西：

     • Runtime: running

     • Connectivity probe: ok

2. 紧接着查通道探测状态。 确认 Telegram 通道这一层的 transport 是否显示 connected，以及是否标记为 works 或

   audit ok

   。
3. 如果运行时一切健康，唯独 Telegram 通道不通，这时候才回去检查 Token 和配置。 排查重点：
   • Config 文件里的 botToken 值有没有粘贴对。
   • 环境变量 TELEGRAM_BOT_TOKEN 有没有被错误覆盖或缺失。
4. 如果碰到

   telegram plugin not available

   的报错，这不再是 Token 配置的问题。 这说明插件依赖坏了。
   • 执行

     openclaw doctor --fix

     尝试自动清理并修复依赖树。
   • 如果执行后重启网关依旧没用，可能需要手动运行

     openclaw plugins enable telegram

     再去重启。

给你的明确结论

1. OpenClaw Telegram 机器人要正常工作，必须同时满足：网关在跑 且 Token 正确存在于 config 或环境变量中。
2. 它明确不使用

   openclaw channels login telegram

   这条命令来激活，不要被某些教程带偏。
3. 想要最快速度判断出问题出在哪，别再去向任何人追要更多信息，直接跑上面那套 diagnostic 命令，看 Runtime、Probe、Channel 这三个维度的结果。

我的把握度

• 关于“Runtime/Probe/Token”的这套排查步骤，有清晰的官方文档支持，方向绝对可靠。
• 关于“网关 CPU 空转导致机器人卡死”这一点，有实际错误报告的佐证，是目前已知的有效排查方向之一，但尚不能在没有亲眼看到你的诊断数据前，就给机器判死刑。

最后一句话总结：OpenClaw 的 Telegram Bot 死在哪里，一看网关 Probe，二看 Telegram 通道探测，三看 Config/Env 里的 Bot Token；它根本不用 login flow，只认 token 配置。