Pairing pending
像对方还站在门口没被登记放行。
Gateway 导读
先跑这 5 条命令，再查具体症状
页面按“命令梯子→常见故障”组织，最优先跑 `openclaw status` → `gateway status` → `logs` → `doctor` → `channels status --probe` 确认健康状态。最容易踩的坑是“群消息没人回”时别急着重连，先查配对状态和 @提及策略。
先讲这一页到底在解决什么
先跑这 5 条命令，再查具体症状
页面按“命令梯子→常见故障”组织，最优先跑 `openclaw status` → `gateway status` → `logs` → `doctor` → `channels status --probe` 确认健康状态。最容易踩的坑是“群消息没人回”时别急着重连，先查配对状态和 @提及策略。
先做什么
🪜 官方给了一架“命令梯子”，别跳步
这几条命令的顺序非常值钱。因为它能防止你一头冲去重启、删文件、重装，结果越查越乱。
openclaw status像先站在门口看总牌子：整体有没有亮灯，别一上来就钻进机房深处。
openclaw gateway status像再往前一步，看总机房自己是不是在运行、RPC 探针是不是通的。
openclaw logs --follow像站进监控室，看问题是正在发生，还是只是历史残影。
openclaw doctor / openclaw channels status --probe一个像全科医生，一个像去各个通道门口敲门确认它们还醒着。
没回复时
📭 通道明明亮着，但没人回话？先查门卫规则，不要先怪网络
官方这里的态度很实用：很多“不回复”问题，其实不是链路断了，而是策略把消息拦掉了。
requireMention
像群里没点名叫它，所以门卫决定先别让它出声。
Allowlist mismatch
像人到了门口，但名单上根本没有他。
一句话
“没回复”常常是规则问题，不一定是连接坏了。
Control UI 连不上
🖥 Dashboard 连不上时，往往是“门牌、门卡、握手方式”三选一出了错
官方把这块拆得很细，但抓住共性就好。
Host/port/url 错了
像人跑到了隔壁楼门口，自然一直敲不开。
Auth mode / token mismatch
像门是对的，但掏出的门卡不是这一栋认的那张。
device identity / nonce / signature
像门卫要求你先完成挑战式握手，你却只把老票据拍在桌上。
AUTH_TOKEN_MISMATCH / PAIRING_REQUIRED官方连错因代码都给你分好了。把它们当成门口告示牌，会比硬猜快很多。
服务没起来
🚫 Gateway 服务起不来时，最常见的是三件事：模式不对、门没锁、端口被占
这是那种一看像大故障，实际往往很具体的页。
gateway.mode=local
像系统发现你想在本地开机房，但配置却还写着“我不在本地值班”。
non-loopback without auth
像你想把大门朝外开，但忘了先装门锁。
EADDRINUSE
像那扇门牌已经被别的人占用了，你再开就撞车。
一句话
先看模式，再看门锁，再看端口，别直接重装。
定时任务和心跳
⏰ Cron / Heartbeat 出问题时，先确认“有没有排班”，再看“排班时送给谁”
官方这一段很像值班系统排错表。
openclaw cron status / cron list像先翻排班表，看看定时工人到底有没有被排上班。
openclaw system heartbeat last像查看最近一次巡逻员的值班记录。
quiet-hours / dm-blocked
像不是系统坏了，而是巡逻员按规则本来就该安静，或者不准直接敲私聊门。
📌 记一句
很多“没送达”不是失败，而是被规则正常跳过了。
最后总结
🎈 把这页压成一句最短的话
Troubleshooting 就是总机房急救手册：先爬命令梯子，再按症状找病因，别一上来就乱动配置和服务。
如果你已经知道问题多半和钥匙、凭证、秘密存放有关，下一页就去 /gateway/secrets。