频道故障排查

当频道已连接但行为异常时，请参考本页进行排查。

诊断命令流程

按顺序依次运行以下命令：

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

正常状态基准：

症状	快速检查	修复方案
已连接但私信无回复	`openclaw pairing list whatsapp`	批准发送者或调整私信策略/白名单。
群组消息被忽略	检查配置中的 `requireMention` + 提及模式	提及机器人或放宽该群组的提及策略。
随机断连/重复登录	`openclaw channels status --probe` + 查看日志	重新登录并确认凭据目录完好。

症状	快速检查	修复方案
`/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 status --probe`	允许服务器/频道并确认消息内容意图已启用。
群组消息被忽略	检查日志中的提及过滤丢弃	提及机器人或设置服务器/频道 `requireMention: false`。
私信无回复	`openclaw pairing list discord`	批准私信配对或调整私信策略。

症状	快速检查	修复方案
Socket 模式已连接但无响应	`openclaw channels status --probe`	确认 app token + bot token 及必要权限范围。
私信被阻止	`openclaw pairing list slack`	批准配对或放宽私信策略。
频道消息被忽略	检查 `groupPolicy` 和频道白名单	允许该频道或将策略切换为 `open`。

症状	快速检查	修复方案
无入站事件	确认 webhook/服务器可达性和应用权限	修复 webhook URL 或 BlueBubbles 服务器状态。
macOS 上能发不能收	检查 macOS 对 Messages 自动化的隐私权限	重新授予 TCC 权限并重启频道进程。
私信发送者被阻止	`openclaw pairing list imessage` 或 `openclaw pairing list bluebubbles`	批准配对或更新白名单。

完整排查指南：

症状	快速检查	修复方案
守护进程可达但机器人无反应	`openclaw channels status --probe`	确认 `signal-cli` 守护进程 URL/账户及接收模式。
私信被阻止	`openclaw pairing list signal`	批准发送者或调整私信策略。
群组回复未触发	检查群组白名单和提及模式	添加发送者/群组或放宽过滤条件。

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