Skip to main content

​
频道故障排查

当频道连接但行为异常时使用本页面。

​
命令步骤

请按顺序先运行以下命令： 
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
健康基线：
  • Runtime: running（运行时：运行中）
  • RPC probe: ok（RPC 探针：正常）
  • 频道探测显示已连接/准备就绪

​
WhatsApp

​
WhatsApp 故障特征

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

​
Telegram

​
Telegram 故障特征

症状最快检查修复
/start 后无有效回复流程openclaw pairing list telegram批准配对或更改 DM 策略。
机器人在线但群组保持沉默验证提及需求和机器人隐私模式禁用隐私模式以允许群组可见，或提及机器人。
发送失败伴网络错误检查日志中的 Telegram API 调用失败修复 api.telegram.org 的 DNS/IPv6/代理路由。
升级后被白名单阻拦openclaw security audit 和配置白名单运行 openclaw doctor --fix 或用数字发送者 ID 替换 @username。
完整故障排查：/channels/telegram#troubleshooting

​
Discord

​
Discord 故障特征

症状最快检查修复
机器人在线但公会无回复openclaw channels status --probe允许公会/频道并验证消息内容意图权限。
群组消息被忽略检查日志中的提及门控丢弃提及机器人或将公会/频道设置为 requireMention: false。
DM 回复缺失openclaw pairing list discord批准 DM 配对或调整 DM 策略。
完整故障排查：/channels/discord#troubleshooting

​
Slack

​
Slack 故障特征

症状最快检查修复
套接字模式已连接但无响应openclaw channels status --probe验证应用令牌 + 机器人令牌及所需权限。
私信被阻止openclaw pairing list slack批准配对或放宽 DM 策略。
频道消息被忽略检查 groupPolicy 和频道白名单允许该频道或将策略切换为 open。
完整故障排查：/channels/slack#troubleshooting

​
iMessage 和 BlueBubbles

​
iMessage 和 BlueBubbles 故障特征

症状最快检查修复
无入站事件验证 webhook/服务器可达性和应用权限修复 webhook URL 或 BlueBubbles 服务器状态。
macOS 可发送但不接收检查 macOS 讯息自动化的隐私权限重新授权 TCC 权限并重启频道进程。
私信发送者被阻止openclaw pairing list imessage 或 openclaw pairing list bluebubbles批准配对或更新白名单。
完整故障排查：

​
Signal

​
Signal 故障特征

症状最快检查修复
守护进程可达但机器人无响应openclaw channels status --probe验证 signal-cli 守护进程 URL/账户和接收模式。
私信被阻止openclaw pairing list signal批准发送者或调整 DM 策略。
群组回复无触发检查群组白名单和提及模式添加发送者/群组或放松门控。
完整故障排查：/channels/signal#troubleshooting

​
Matrix

​
Matrix 故障特征

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