Channel Troubleshooting
渠道故障排除
当 Gateway 已经能跑,但消息不进不出、机器人不响应、二维码已登录却没法收发时,问题往往落在具体渠道的配置、权限、意图或网络细节上。
先跑这两个命令
通用审计
openclaw doctor
openclaw channels status --probe 后者会对已知渠道错误给出小型实时检查和告警。
高频渠道问题
Telegram 的 sendMessage / setMyCommands 失败
优先检查到 api.telegram.org 的 DNS、IPv6 和出站 HTTPS 连通性。很多 VPS 的症状不是 token 错,而是网络出不去。
Discord 机器人在线但频道里不回复
先确认 Message Content Intent 已启用,再检查 guild / channel allowlist 与 requireMention 是否把消息挡掉了。
WhatsApp 已扫码但消息还是不工作
查看会话是否仍在线、凭证文件是否更新,以及日志里是否出现 loggedOut 或 409–515 一类状态。必要时执行 logout + login 重建会话。