当 OpenClaw 渠道显示“已连接”但消息没有正确回复时，按渠道排查特征是最高效的方式。先运行 openclaw status、openclaw gateway status、openclaw doctor 等诊断命令确认整体状态，再对照各渠道故障特征表（如 WhatsApp 的 QR 登录超时 408、Telegram 的 setMyCommands 被拒绝等）执行最快检查与修复。

OpenClaw 渠道故障排查：常见症状与修复命令

诊断命令梯子

按顺序先跑一遍：

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

健康基线：

• Runtime: running
• Connectivity probe: ok
• Capability: read-only、write-capable 或 admin-capable
• 渠道探针显示传输连接正常，并且支持的位置显示 works 或 audit ok

更新后渠道消失

当 Telegram、iMessage、BlueBubbles 时代配置或其他插件渠道在更新后消失时使用：

openclaw status --all
openclaw doctor --fix
openclaw gateway restart
openclaw status --all

观察 openclaw status --all 中是否出现 plugin load failed: dependency tree corrupted; run openclaw doctor --fix。这表示渠道已配置，但插件安装/加载路径遇到受损的依赖树，导致渠道未注册。openclaw doctor --fix 会清理过时的插件依赖暂存目录和过期的认证影子，然后 openclaw gateway restart 重新加载干净状态。

WhatsApp

WhatsApp 故障特征

症状	最快检查	修复方案
已连接但私信无回复	openclaw pairing list whatsapp	批准发送方，或切换 DM 策略/白名单。
群组消息被忽略	检查配置中的 requireMention 和提及模式	提及机器人，或放宽该群组的提及策略。
QR 登录超时（408 错误）	检查网关 HTTPS_PROXY / HTTP_PROXY 环境变量	设置可达的代理；NO_PROXY 仅用于绕过。
随机断连/重新登录循环	openclaw channels status --probe + 查看日志	近期重连会在当前已连接时被标记；观察日志，重启网关，如果反复断连则重新链接。
消息延迟到达（秒/分钟）	openclaw doctor --fix	Doctor 会停止已验证的过期本地 TUI 客户端——这些客户端正在拖慢网关事件循环。

完整排查：WhatsApp 故障排查

Telegram

Telegram 故障特征

症状	最快检查	修复方案
/start 但没有可用的回复流	openclaw pairing list telegram	批准配对或更改 DM 策略。
机器人在线但群组静默	确认提及要求和机器人隐私模式	禁用群组可见性的隐私模式，或提及机器人。
发送失败并报网络错误	检查日志中的 Telegram API 调用失败	修复到 api.telegram.org 的 DNS/IPv6/代理路由。
启动时报 getMe returned 401	检查配置的 token 来源	重新复制或生成 BotFather 的 token，更新 botToken、tokenFile 或默认账号的 TELEGRAM_BOT_TOKEN。
轮询卡住或重连缓慢	openclaw logs --follow 查看轮询诊断信息	升级；如果重启是误报，调整 pollingStallThresholdMs。持续卡住仍可能是代理/DNS/IPv6 问题。
启动时 setMyCommands 被拒绝	检查日志中的 BOT_COMMANDS_TOO_MUCH	减少插件/技能/自定义 Telegram 命令，或禁用原生菜单。
升级后白名单拦截了自己	openclaw security audit 和配置白名单	运行 openclaw doctor --fix，或将 @username 替换为数字发送方 ID。

完整排查：Telegram 故障排查

Discord

Discord 故障特征

症状	最快检查	修复方案
机器人在线但 guild 无回复	openclaw channels status --probe	允许 guild/频道并验证消息内容意图。
群组消息被忽略	检查日志中的提及门控丢弃	提及机器人，或将 guild/频道的 requireMention 设为 false。
打字/Token 消耗但没有 Discord 消息	检查这是否是 ambient room 事件或已 opt-in 的 message_tool 房间，且模型未调用 message(action=send)	查看网关详细日志中是否丢弃了最终 payload 元数据；验证 messages.groupChat.unmentionedInbound；阅读 Ambient room 事件；或针对普通群组请求保持 messages.groupChat.visibleReplies: "automatic"。
DM 回复缺失	openclaw pairing list discord	批准 DM 配对或调整 DM 策略。

完整排查：Discord 故障排查

Slack

Slack 故障特征

症状	最快检查	修复方案
Socket Mode 已连接但无回复	openclaw channels status --probe	验证 App Token + Bot Token 及所需权限范围；对于 SecretRef 备份的设置，关注 botTokenStatus / appTokenStatus = configured_unavailable。
DM 被拦截	openclaw pairing list slack	批准配对或放宽 DM 策略。
频道消息被忽略	检查 groupPolicy 和频道白名单	允许该频道或将策略切换为 open。

完整排查：Slack 故障排查

iMessage

iMessage 故障特征

症状	最快检查	修复方案
imsg 缺失或在非 macOS 上失败	openclaw channels status --probe --channel imessage	在运行 Messages 的 Mac 上运行 OpenClaw，或使用 SSH wrapper 设置 cliPath。
macOS 上可发送但无法接收	检查 macOS Messages 自动化的隐私权限	重新授权 TCC 权限并重启渠道进程。
DM 发送方被拦截	openclaw pairing list imessage	批准配对或更新白名单。

完整排查：iMessage 故障排查

Signal

Signal 故障特征

症状	最快检查	修复方案
守护进程可达但机器人静默	openclaw channels status --probe	验证 signal-cli 守护进程 URL/账号和接收模式。
DM 被拦截	openclaw pairing list signal	批准发送方或调整 DM 策略。
群组回复不触发	检查群组白名单和提及模式	添加发送方/群组或放宽门控。

完整排查：Signal 故障排查

QQ Bot

QQ Bot 故障特征

症状	最快检查	修复方案
机器人回复“gone to Mars”	验证配置中的 appId 和 clientSecret	设置凭证或重启网关。
无入站消息	openclaw channels status --probe	在 QQ 开放平台验证凭证。
语音未转写	检查 STT 提供者配置	配置 channels.qqbot.stt 或 tools.media.audio。
主动消息未到达	检查 QQ 平台互动要求	QQ 可能拦截无近期互动的机器人主动消息。

完整排查：QQ Bot 故障排查

Matrix

Matrix 故障特征

症状	最快检查	修复方案
已登录但忽略房间消息	openclaw channels status --probe	检查 groupPolicy、房间白名单和提及门控。
DM 不处理	openclaw pairing list matrix	批准发送方或调整 DM 策略。
加密房间失败	openclaw matrix verify status	重新验证设备，然后检查 openclaw matrix verify backup status。
备份恢复未完成/损坏	openclaw matrix verify backup status	运行 openclaw matrix verify backup restore 或使用恢复密钥重新运行。
跨签名/引导状态异常	openclaw matrix verify bootstrap	一次修复密钥存储、跨签名和备份状态。

完整配置文档：Matrix

相关文档

• 配对
• 渠道路由
• 网关故障排查

常见问题

为什么 Telegram 机器人启动时提示 BOT_COMMANDS_TOO_MUCH？

日志中出现 setMyCommands 被拒绝，表明插件/技能/自定义 Telegram 命令过多。减少命令数量或禁用原生菜单即可解决。

WhatsApp 连接正常但私信无回复怎么办？

先运行 openclaw pairing list whatsapp 查看是否有未批准的发送方。批准配对或调整 DM 策略（如 dmPolicy: allow_all）即可恢复回复。

iMessage 发送正常但收不到消息如何排查？

检查 macOS 隐私权限：确保 Messages 自动化已授予 TCC 权限。重新授权后重启 iMessage 渠道进程（openclaw gateway restart）。也可通过 openclaw channels status --probe --channel imessage 确认渠道状态。