本文汇总 OpenClaw 各主要频道的常见故障症状和快速修复方法，适合在 Bot 连接正常但行为异常时使用。
通用诊断命令（先运行这些）
遇到问题时，按顺序执行以下命令：
bash
openclaw status # 检查整体运行状态
openclaw gateway status # 检查 Gateway 状态
openclaw logs --follow # 实时查看日志
openclaw doctor # 自动诊断常见问题
openclaw channels status --probe # 探测各频道连接状态健康基线：
Runtime: runningRPC probe: ok- 频道探测显示 connected/ready
WhatsApp 故障速查
| 症状 | 最快检查方法 | 修复方案 |
|---|---|---|
| 已连接但 DM 无回复 | openclaw pairing list whatsapp | 审批发送者，或切换 DM 策略/白名单 |
| 群消息被忽略 | 检查配置中的 requireMention + mentionPatterns | @提及 Bot，或放宽该群的提及策略 |
| 随机断线/重新登录循环 | openclaw channels status --probe + 日志 | 重新登录，检查凭证目录是否正常 |
完整排查：WhatsApp 频道文档
Telegram 故障速查
| 症状 | 最快检查方法 | 修复方案 |
|---|---|---|
/start 后无回复流程 | openclaw pairing list telegram | 审批配对，或修改 DM 策略 |
| Bot 在线但群组静默 | 检查提及要求和 Bot 隐私模式 | 禁用 BotFather 隐私模式，或在群组 @提及 Bot |
| 发送失败/网络错误 | 查看日志中的 Telegram API 调用失败 | 修复 DNS/IPv6/代理路由到 api.telegram.org |
| 升级后白名单锁定自己 | openclaw security audit + 配置白名单 | 运行 openclaw doctor --fix，或将 @username 替换为数字发送者 ID |
完整排查：Telegram 频道文档
Telegram 白名单 ID 建议：白名单中使用数字用户 ID（而非
@username），可以避免用户名变更后白名单失效。
Discord 故障速查
| 症状 | 最快检查方法 | 修复方案 |
|---|---|---|
| Bot 在线但服务器无回复 | openclaw channels status --probe | 允许服务器/频道，检查 Message Content Intent |
| 群消息被忽略 | 查看日志中的提及拦截记录 | @提及 Bot，或设置服务器/频道 requireMention: false |
| DM 回复缺失 | openclaw pairing list discord | 审批 DM 配对，或调整 DM 策略 |
关键提示：Discord Bot 必须在 Discord Developer Portal 启用 Message Content Intent，否则无法读取消息内容。
完整排查：Discord 频道文档
Slack 故障速查
| 症状 | 最快检查方法 | 修复方案 |
|---|---|---|
| Socket Mode 已连接但无响应 | openclaw channels status --probe | 验证 App Token + Bot Token 和所需 Scopes |
| DM 被拦截 | openclaw pairing list slack | 审批配对，或放宽 DM 策略 |
| 频道消息被忽略 | 检查 groupPolicy 和频道白名单 | 允许该频道，或切换策略为 open |
Slack 必要权限 Scopes：channels:read、chat:write、im:read、im:write、app_mentions:read
完整排查：Slack 频道文档
iMessage / BlueBubbles 故障速查
| 症状 | 最快检查方法 | 修复方案 |
|---|---|---|
| 无入站事件 | 检查 Webhook/服务器可达性和 App 权限 | 修复 Webhook URL 或 BlueBubbles 服务器状态 |
| 可发送但 macOS 上无法接收 | 检查 macOS Messages 自动化隐私权限 | 重新授权 TCC 权限并重启频道进程 |
| DM 发送者被拦截 | openclaw pairing list imessage 或 openclaw pairing list bluebubbles | 审批配对，或更新白名单 |
macOS TCC 权限路径： 系统设置 → 隐私与安全性 → 自动化 → 确认 OpenClaw 对 Messages 有权限
完整���查：
Signal 故障速查
| 症状 | 最快检查方法 | 修复方案 |
|---|---|---|
| Daemon 可达但 Bot 静默 | openclaw channels status --probe | 检查 signal-cli Daemon URL/账号 和接收模式 |
| DM 被拦截 | openclaw pairing list signal | 审批发送者，或调整 DM 策略 |
| 群组回复不触发 | 检查群组白名单和提及 Patterns | 添加发送者/群组，或放宽触发条件 |
完整排查：Signal 频道文档
Matrix 故障速查
| 症状 | 最快检查方法 | 修复方案 |
|---|---|---|
| 已登录但忽略房间消息 | openclaw channels status --probe | 检查 groupPolicy 和房间白名单 |
| DM 不处理 | openclaw pairing list matrix | 审批发送者，或调整 DM 策略 |
| 加密房间失败 | 检查加密模块和加密设置 | 启用加密支持，重新加入并同步房间 |
完整排查：Matrix 频道文档
位置消息支持说明
OpenClaw 将各频道的位置分享归一化为统一格式：
文本展示格式：
- 位置 Pin：
📍 48.858844, 2.294351 ±12m - 命名地点：
📍 Eiffel Tower — Champ de Mars, Paris (48.858844, 2.294351 ±12m) - 实时位置：
🛰 Live location: 48.858844, 2.294351 ±12m
位置上下文字段（ctx 中可用）：
| 字段 | 类型 | 说明 |
|---|---|---|
LocationLat | number | 纬度 |
LocationLon | number | 经度 |
LocationAccuracy | number | 精度（米，可选） |
LocationName | string | 地点名称（可选） |
LocationAddress | string | 地址（可选） |
LocationSource | string | pin / place / live |
LocationIsLive | boolean | 是否为实时位置分享 |
支持位置的频道：Telegram（位置 Pin + 场所 + 实时位置）、WhatsApp（locationMessage + liveLocationMessage）、Matrix（m.location with geo_uri）
原文：Channel Troubleshooting + Channel Location Parsing | 来源：OpenClaw 官方文档