当 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: runningConnectivity probe: okCapability: 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 故障特征
| 症状 | 最快检查 | 修复方案 |
|---|---|---|
| 已连接但私信无回复 | 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 确认渠道状态。