频道故障排除

当频道已连接但行为不正确时，请使用此页面。

命令阶梯

首先按顺序运行：

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 + 日志重新登录并验证凭据目录健康。

完整故障排除：/zh/docs/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。

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

Discord

Discord 故障特征

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

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

Slack

Slack 故障特征

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

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

iMessage 和 BlueBubbles

iMessage/BlueBubbles 故障特征

症状最快检查修复
无连接openclaw channels status --probe检查 BlueBubbles 服务器是否运行
消息未发送检查日志中的 API 错误验证 BlueBubbles 服务器 URL 和 API 密钥
消息未收到检查 dmPolicy 设置确认发件人在白名单中（如果使用白名单）

完整故障排除：

Signal

Signal 故障特征

症状最快检查修复
无连接openclaw channels status --probe检查 signal-cli 是否正确配置
消息未发送检查日志中的错误验证电话号码和信号配置
DM 被阻止检查 dmPolicy 设置确认配对已批准或切换策略

完整故障排除：/zh/docs/channels/signal

通用故障排除命令

# 检查所有频道状态
openclaw channels status

# 探测特定频道
openclaw channels status --probe

# 查看实时日志
openclaw logs --follow

# 运行诊断
openclaw doctor

# 检查特定频道的日志
openclaw logs --channel whatsapp
openclaw logs --channel telegram

常见修复

重新链接频道

# 注销并重新登录
openclaw channels logout --channel whatsapp
openclaw channels login --channel whatsapp

清除凭据

# 清除并重新配置
rm -rf ~/.openclaw/credentials/whatsapp-*
openclaw channels login --channel whatsapp

检查配置

# 获取当前频道配置
openclaw config get channels.whatsapp
openclaw config get channels.telegram

诊断步骤

  1. 检查状态

    openclaw status
openclaw channels status

  2. 检查日志

    openclaw logs --follow

  3. 运行诊断

    openclaw doctor

  4. 探测频道

    openclaw channels status --probe

  5. 检查配对

    openclaw pairing list whatsapp
openclaw pairing list telegram

获得帮助

如果这些步骤没有解决您的问题：

  • 检查 OpenClaw 文档
  • 加入 OpenClaw 社区
  • 在 GitHub 上提交问题

相关链接