Appearance
Telegram 问题
编号格式
#NNNNN对应 GitHub issue，可直接搜索去重。
消息被重复接收和处理
来源：GitHub #38681（2026-03）
现象：Telegram 上的每条消息会被 Agent 处理多次，用户收到重复回复。
原因：
- 多个 Gateway 实例同时使用同一个 Bot Token 进行监听
- webhook 模式和 polling 模式同时开启，消息被双重消费
解决方法：
确保全局只有一个 Gateway 实例使用该 Bot Token：
bashopenclaw gateway status确认
openclaw.json中 Telegram 只用一种接收模式：json5{ channels: { telegram: { enabled: true, mode: "polling" // 确认只写一种模式 } } }如在多台机器都配置了 OpenClaw，确保只有一台正在运行并监听该 Bot。
消息不触发 Agent（WebChat 正常）
来源：GitHub #38606（2026-03）
现象：从 Telegram 发消息后 Agent 没有响应，但通过 WebChat（Control UI）发送给同一个 Agent 的消息正常处理，日志中没有明显错误。
原因：Telegram channel 与 session 的绑定失效，该渠道处于挂起（stale）状态，不再转发消息到 Agent。
解决方法：
bash
# 查看渠道当前状态（确认是否 connected）
openclaw channels
# 重启 Gateway 以重建连接
openclaw gateway restart如果问题复现，检查 openclaw channels 列表中该渠道状态是否为 connected。