Channel Troubleshooting | OpenClaw 中文解释版

当你的机器人连上了某个聊天软件，但不听话时，别着急。我们先按顺序做几个简单的检查，就像医生先量体温一样。

先运行几个检查命令：你需要打开电脑上的“命令行”工具（一个可以打字下命令的黑色窗口），按顺序输入下面几行字。每输入一行，就按一下回车键，看看它告诉你什么。
- openclaw status：看看机器人是不是在“跑步”（运行）。
- openclaw gateway status：看看机器人的“大门”（网关）开没开。
- openclaw logs --follow：看看机器人的“日记本”（日志）里写了什么，跟着看最新的记录。
- openclaw doctor：让机器人自己给自己“看病”，检查身体。
- openclaw channels status --probe：特别检查一下每个聊天软件的连接是不是真的健康。
如果一切健康，你会看到像“Runtime: running”（正在跑步）、“RPC probe: ok”（内部通话正常）这样的好消息。

接下来，我们看看不同聊天软件容易出什么问题。你可以把它想成不同的小动物，生病的样子不一样。

WhatsApp 小鹿

症状：连上了，但私聊不回复。
- 检查：输入 openclaw pairing list whatsapp，看看发消息的人是不是在“好朋友名单”里。
- 治疗：把那个人加到名单里，或者修改一下“谁可以私聊我”的规则。
症状：群里的消息不理我。
- 检查：看看设置里是不是要求必须“@提到”机器人才会理人。
- 治疗：在群里@一下机器人，或者把那个群的规则改成不用@也能理人。
症状：总是自己断开又重连，像在转圈圈。
- 检查：用 openclaw channels status --probe 和看日志。
- 治疗：重新登录一下，并检查登录用的“钥匙串”（凭证目录）是不是好的。

Telegram 小飞机

症状：发了 /start 但机器人没反应。
- 检查：输入 openclaw pairing list telegram，看看你是不是在它的“许可名单”里。
- 治疗：让管理员批准你，或者修改私聊规则。
症状：机器人在线，但在群里不说话。
- 检查：看看是不是必须@它，或者机器人的“隐私模式”是不是打开了。
- 治疗：关掉那个群的隐私模式，或者在群里@它。
小心网络问题：如果发送失败，可能是网络没连到 Telegram 的家（api.telegram.org），要检查一下。

Discord 小游戏手柄

症状：机器人在服务器里，但不回复。
- 检查：用 openclaw channels status --probe。
- 治疗：确保机器人被允许在那个频道说话，并且它有“读取消息”的权限。
症状：私聊不回复。
- 检查：输入 openclaw pairing list discord。
- 治疗：批准私聊，或者修改私聊规则。

Slack 小扳手

症状：连上了但没反应。
- 检查：用 openclaw channels status --probe。
- 治疗：检查两种“令牌”（App Token 和 Bot Token）对不对，以及权限够不够。
症状：某个频道的消息被忽略。
- 检查：看看那个频道是不是在“允许名单”里。
- 治疗：把频道加进去，或者把群组规则改成“开放”。

iMessage 和 BlueBubbles（苹果信息）

症状：收不到任何消息。
- 检查：看看“网络钩子”（Webhook）地址对不对，服务器能不能访问，App有没有权限。
- 治疗：修好网络钩子地址，或者检查 BlueBubbles 服务器状态。
特别提醒（苹果电脑）：如果能发不能收，可能是电脑的“隐私权限”没给够。需要去系统设置里，重新给“信息”App授权，然后重启机器人。

Signal 小锁头

症状：后台程序在，但机器人沉默。
- 检查：用 openclaw channels status --probe。
- 治疗：检查 signal-cli 这个后台程序的地址和账号对不对，以及是不是设置成了接收模式。
症状：群回复不触发。
- 检查：看看群或发消息的人是不是在允许名单里。
- 治疗：把他们加进去，或者放松一点规则。

Matrix 小网格

如果这里的方法还不够，每个软件下面都提供了一个“完整说明书”的链接，你可以点进去看更详细的步骤。