频道故障排查

通用排查步骤

遇到频道问题时，按以下顺序排查：

# 1. 检查 Gateway 是否在运行
openclaw status

# 2. 检查频道连接状态
openclaw channels status

# 3. 查看实时日志
openclaw logs --follow

# 4. 深度健康检查
openclaw status --deep

# 5. 自动诊断修复
openclaw doctor

# 6. 重启 Gateway
openclaw gateway restart

各频道常见问题

QQ 机器人

问题	解决方案
机器人没有响应	检查 Gateway 运行状态：openclaw status
渠道配置失败	确认 Token 格式为 AppID:AppSecret，中间用英文冒号
发送消息报错	openclaw channels status 查看连接状态
群聊不回复	确认群里需要 @机器人 才会触发

飞书

问题	解决方案
长连接保存失败	确保 Gateway 已启动且飞书渠道已添加
权限不足	进入飞书开放平台「权限管理」批量导入权限 JSON
机器人不回复	检查事件订阅是否添加了 im.message.receive_v1
配对码未收到	确认 DM 配对策略已正确配置：dmPolicy: pairing
国际版 Lark	需设置 domain: "lark"

Telegram

问题	解决方案
Bot Token 失效	在 BotFather 重新获取 Token
无法接收消息	检查网络连接（需要科学上网）
配对失败	openclaw pair list 查看待批准的配对请求

WhatsApp

问题	解决方案
QR 码扫描超时	重新执行登录命令
频繁掉线	检查手机网络状态，保持手机在线

Discord

问题	解决方案
Bot 无响应	检查 Message Content Intent 是否在 Discord 开发者后台开启
权限不足	确认 Bot 已被赋予读取消息和发送消息的权限

微信

问题	解决方案
iPad 协议登录失败	协议随时可能被封，优先使用企业微信方案
消息延迟	检查桥接服务是否正常运行

通用解决方案

Agent 只给建议不干活

这是最常见的问题，通常是 Tools Profile 设置错误：

# 检查当前配置
openclaw config get tools.profile

# 修复：设置为 full
openclaw config set tools.profile full
openclaw gateway restart

v3.7 之前版本 Bug

OpenClaw 3.7 之前存在 Bug：即使向导中显示 Tools profile: full，实际默认值可能是 messaging。升级到 3.7+ 或手动修复。

配置修改后不生效

修改 openclaw.json 后必须重启 Gateway：

openclaw gateway restart

多渠道同时使用

OpenClaw 支持同时接入多个平台，共享同一个 AI 大脑。如果某个渠道出问题，不会影响其他渠道。