文档
聊天渠道
渠道故障排除

渠道故障排除

当渠道“显示已连接”，但消息行为不符合预期时，优先使用这里的快速排障梯子。

命令梯子（先按顺序跑一遍） 

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

健康基线通常包含：

  • Runtime: running
  • RPC probe: ok
  • 渠道 probe 显示 connected/ready

WhatsApp

常见症状与最快修复路径：

现象最快检查常见修复
已连接但私信不回复openclaw pairing list whatsapp批准发送者配对，或调整 DM 策略/允许列表
群里不响应检查 requireMention 与提及模式提及机器人，或放宽该群的提及门控
反复断线/重登openclaw channels status --probe + 日志重新登录并检查凭据目录/网络稳定性

相关：/docs/channels/whatsapp/。

Telegram

现象最快检查常见修复
/start 但无法形成对话流openclaw pairing list telegram批准配对码，或调整 dmPolicy
机器人在线但群里沉默检查提及门控 + Telegram 隐私模式提及机器人，或调整隐私模式/管理员权限
网络错误导致发送失败日志中的 Telegram API 调用失败排查 DNS/IPv6/代理路由

相关：/docs/channels/telegram/。

Discord

现象最快检查常见修复
机器人在线但服务器频道不回复openclaw channels status --probe校验 guild/channel 允许列表与 Message Content Intent
群消息被忽略日志中出现“提及门控丢弃”提及机器人，或对该服务器/频道设置 requireMention: false
私信不回复openclaw pairing list discord批准配对，或调整 DM 策略

相关：/docs/channels/discord/。

需要更深的诊断

如果命令梯子无法定位问题，优先整理以下信息再继续：

  • 版本：openclaw version
  • 复现步骤（最短路径）
  • openclaw doctor 输出（注意隐藏敏感信息）
  • 相关时间段日志片段（openclaw logs --follow）
配对渠道路由