Skip to main content
当某个频道已连接但行为异常时，请使用此页面。

​
命令阶梯

请先按顺序运行以下命令： 
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
健康基线：
  • Runtime: running
  • Connectivity probe: ok
  • Capability: read-only, write-capable, or 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 失败特征

症状最快检查项修复方法
已连接但没有 DM 回复openclaw pairing list whatsapp批准发送者或切换 DM 策略/允许列表。
群组消息被忽略检查配置中的 requireMention + 提及模式提及机器人，或放宽该群组的提及策略。
带有 408 的 QR 登录超时检查网关 HTTPS_PROXY / HTTP_PROXY 环境变量设置可访问的代理；仅将 NO_PROXY 用于绕过。
随机断开/重新登录循环openclaw channels status --probe + 日志即使当前已连接，最近的重连也会被标记；观察日志，重启网关，然后如果仍然频繁抖动就重新关联。
status=408 Request Time-out 循环探测、日志、doctor，然后查看网关状态先修复主机连通性/时序；备份认证信息并在循环持续时重新关联账户。
回复延迟数秒/数分钟到达openclaw doctor --fix当已验证的本地旧 TUI 客户端正在拖慢 Gateway 事件循环时，doctor 会将其停止。
完整故障排查：WhatsApp 故障排查

​
Telegram

​
Telegram 失败特征

症状最快检查项修复方法
/start 但没有可用的回复流程openclaw pairing list telegram批准配对或更改 DM 策略。
机器人在线但群组保持沉默验证提及要求和机器人隐私模式对群组可见性禁用隐私模式，或提及机器人。
发送失败并伴随网络错误检查日志中的 Telegram API 调用失败修复到 api.telegram.org 的 DNS/IPv6/代理路由。
启动时报告 getMe returned 401检查已配置的令牌来源重新复制或重新生成 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，或用数字发送者 ID 替换 @username。
完整故障排查：Telegram 故障排查

​
Discord

​
Discord 失败特征

症状最快检查项修复方法
机器人在线但没有 guild 回复openclaw channels status --probe允许 guild/channel 并验证消息内容意图。
群组消息被忽略检查日志中提及门控丢弃提及机器人，或将 guild/channel 设置为 requireMention: false。
有打字/令牌使用但没有 Discord 消息检查这是否是环境房间事件，或是一个选择加入的 message_tool 房间，其中模型遗漏了 message(action=send)检查网关详细日志中被抑制的最终负载元数据，验证 messages.groupChat.unmentionedInbound，阅读 环境房间事件，或者在正常群组请求中保持 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，或为 cliPath 使用 SSH 封装器。
在 macOS 上可以发送但无法接收检查 Messages automation 的 macOS 隐私权限重新授予 TCC 权限并重启频道进程。
DM 发送者被阻止openclaw pairing list imessage批准配对或更新允许列表。
完整故障排查：

​
Signal

​
Signal 失败特征

症状最快检查项修复方法
守护进程可达但机器人沉默openclaw channels status --probe验证 signal-cli 守护进程 URL/账户和接收模式。
DM 被阻止openclaw pairing list signal批准发送者或调整 DM 策略。
群组回复不触发检查群组允许列表和提及模式添加发送者/群组，或放宽门控。
完整故障排查：Signal 故障排查

​
QQ Bot

​
QQ Bot 失败特征

症状最快检查项修复方法
机器人回复“去了火星”验证配置中的 appId 和 clientSecret设置凭据或重启网关。
没有入站消息openclaw channels status --probe验证 QQ Open Platform 上的凭据。
语音未转录检查 STT provider 配置配置 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一次性修复 secret storage、交叉签名和备份状态。
完整设置和配置：Matrix

​
相关内容