首页
开始 安装引导快速开始文档总览
文档 渠道接入模型与 APIGateway 运维Tools 与 Skills
更多 精选文章资源导航帮助中心
开始安装
文档导航 聊天渠道
聊天渠道 2 个部分

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 重建会话。