渠道故障排查

本页适用于渠道已连接但行为异常的情况。

诊断命令梯子

按顺序先跑一遍：

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

健康基线：

• Runtime: running
• RPC probe: ok
• 渠道探针显示 connected/ready

WhatsApp

WhatsApp 故障特征

症状	最快检查	修复方案
已连接但私信无回复	openclaw pairing list whatsapp	批准发送方，或切换私信策略/白名单。
群组消息被忽略	检查配置中的 requireMention 和提及模式	提及机器人，或放宽该群组的提及策略。
随机断连/重新登录循环	openclaw channels status --probe + 查看日志	重新登录并确认凭证目录状态正常。

完整排查：/openclaw/channels/whatsapp#troubleshooting

Telegram

Telegram 故障特征

症状	最快检查	修复方案
/start 但没有可用的回复流	openclaw pairing list telegram	批准配对或更改私信策略。
机器人在线但群组静默	确认提及要求和机器人隐私模式	为群组可见性禁用隐私模式，或提及机器人。
发送失败并报网络错误	检查日志中的 Telegram API 调用失败	修复到 api.telegram.org 的 DNS/IPv6/代理路由。
启动时 setMyCommands 被拒绝	检查日志中的 BOT_COMMANDS_TOO_MUCH	减少插件/技能/自定义 Telegram 命令，或禁用原生菜单。
升级后白名单拦截了自己	openclaw security audit 和配置白名单	运行 openclaw doctor --fix，或将 @username 替换为数字发送方 ID。

完整排查：/openclaw/channels/telegram#troubleshooting

Discord

Discord 故障特征

症状	最快检查	修复方案
机器人在线但 guild 无回复	openclaw channels status --probe	允许 guild/频道并验证消息内容意图。
群组消息被忽略	检查日志中的提及门控丢弃	提及机器人，或将 guild/频道的 requireMention 设为 false。
私信无回复	openclaw pairing list discord	批准私信配对或调整私信策略。

完整排查：/openclaw/channels/discord#troubleshooting

Slack

Slack 故障特征

症状	最快检查	修复方案
Socket Mode 已连接但无回复	openclaw channels status --probe	验证 App Token、Bot Token 和所需权限范围。
私信被拦截	openclaw pairing list slack	批准配对或放宽私信策略。
频道消息被忽略	检查 groupPolicy 和频道白名单	允许该频道或将策略切换为 open。

完整排查：/openclaw/channels/slack#troubleshooting

iMessage 和 BlueBubbles

iMessage 和 BlueBubbles 故障特征

症状	最快检查	修复方案
没有入站事件	验证 webhook/服务器可达性和应用权限	修复 webhook URL 或 BlueBubbles 服务器状态。
macOS 上可发送但无法接收	检查 macOS Messages 自动化的隐私权限	重新授权 TCC 权限并重启渠道进程。
私信发送方被拦截	openclaw pairing list imessage 或 openclaw pairing list bluebubbles	批准配对或更新白名单。

完整排查：

• /openclaw/channels/imessage#troubleshooting
• /openclaw/channels/bluebubbles#troubleshooting

Signal

Signal 故障特征

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

完整排查：/openclaw/channels/signal#troubleshooting

Matrix

Matrix 故障特征

症状	最快检查	修复方案
已登录但忽略房间消息	openclaw channels status --probe	检查 groupPolicy 和房间白名单。
私信不处理	openclaw pairing list matrix	批准发送方或调整私信策略。
加密房间失败	验证加密模块和加密设置	启用加密支持并重新加入/同步房间。

完整配置文档：Matrix