OpenClaw 🦞

渠道故障排除

渠道故障排除

当渠道连接但行为错误时使用此页面。

命令阶梯

首先按顺序运行这些：

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

健康基线：

  • Runtime: running
  • RPC probe: ok
  • 渠道探针显示已连接/就绪

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 或将 @username 替换为数字发送者 ID。

完整故障排除：/channels/telegram#troubleshooting

Discord

Discord 故障签名

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

完整故障排除：/channels/discord#troubleshooting

Slack

Slack 故障签名

症状最快检查修复
Socket 模式已连接但无响应openclaw channels status --probe验证应用令牌 + 机器人令牌和所需范围。
DM 被阻止openclaw pairing list slack批准配对或放宽 DM 策略。
频道消息被忽略检查 groupPolicy 和频道允许列表允许频道或将策略切换为 open。

完整故障排除：/channels/slack#troubleshooting

iMessage 和 BlueBubbles

iMessage 和 BlueBubbles 故障签名

症状最快检查修复
无入站事件验证 webhook/服务器可达性和应用权限修复 webhook URL 或 BlueBubbles 服务器状态。
可以发送但在 macOS 上无接收检查 macOS 对 Messages 自动化的隐私权限重新授予 TCC 权限并重启渠道进程。
DM 发送者被阻止openclaw pairing list imessage 或 openclaw pairing list bluebubbles批准配对或更新允许列表。

完整故障排除：

Signal

Signal 故障签名

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

完整故障排除：/channels/signal#troubleshooting

Matrix

Matrix 故障签名

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

完整故障排除：/channels/matrix#troubleshooting