渠道连接问题

本页收录近期 GitHub Issues 中渠道相关高频问题，精选有明确解决方案的案例。

问题 1：Telegram 消息被重复接收和处理

来源：GitHub #38681（2026-03）

现象：Telegram 上的每条消息会被 Agent 处理多次，用户收到重复回复。

原因：存在以下一种或多种情况：

解决方法：

确保全局只有一个 Gateway 实例使用该 Bot Token：
bash
```
openclaw gateway status   # 检查当前 Gateway 状态
```

检查 openclaw.json 中 Telegram 渠道配置，确认 mode 没有冲突：

json

{
  "channels": {
    "telegram": {
      "enabled": true,
      "mode": "polling"   // 确认只使用一种模式
    }
  }
}

来源：GitHub #38606（2026-03）

现象：从 Telegram 发消息后 Agent 没有响应，但通过 WebChat（Control UI）发送给同一个 Agent 的消息正常处理。日志中没有明显错误。

原因：Telegram channel 与 session 的绑定失效，该渠道处于挂起（stale）状态，不再转发消息到 Agent。

解决方法：

bash

# 查看渠道当前状态
openclaw channels

# 重启 Gateway 以重建连接
openclaw gateway restart

如果问题复现，检查 openclaw channels 列表中该渠道的状态是否为 connected。

来源：GitHub #38734（2026-03）

现象：openclaw channels 显示 WhatsApp 状态为 Connected，但实际发送消息时报错 No active WhatsApp Web listener，消息无法送达。

原因：WhatsApp Web 会话在后台静默断开，但连接状态没有及时同步更新，导致 UI 显示正常而实际已断连。

解决方法：

bash

# 断开并重新连接 WhatsApp
openclaw channels disconnect whatsapp
openclaw channels login   # 重新扫码

建议：WhatsApp Web 会话有时效性，长时间不使用或手机重启后容易断连。如频繁出现此问题，考虑在 openclaw.json 中启用自动重连配置。

来源：GitHub #38686（2026-03）

现象：Gateway 日志显示 Agent 已正常处理飞书消息（有 [feishu] 相关日志），但飞书侧用户收不到回复消息。

原因：飞书开放平台的 Verification Token 过期，或与 openclaw.json 中的 channels.feishu.token 配置不一致，导致回调 webhook 签名验证失败，飞书拒绝接受 Gateway 的消息推送。

解决方法：

将该 Token 更新到 openclaw.json：

json

{
  "channels": {
    "feishu": {
      "token": "<最新的 Verification Token>"
    }
  }
}