openclaw pairing required 1008
OpenClaw Pairing Required 1008：根因与修复清单
针对“openclaw pairing required 1008”，给出基于官方文档与社区 issue 的排查路径（避免臆断单一根因）。
1. 报错含义
1008 是 WebSocket policy/authorization 类关闭码，不等于“只有 token 错误”。
2. 三步定位法
按“日志 -> pairing 状态 -> 连接健康”顺序排查，能最快排除高频原因。
- 查看网关日志中的 `unauthorized` / `pairing required` / `invalid-request-frame`
- 运行 `openclaw pairing list feishu` 与 `openclaw devices list` 查看待审批记录
- 确认 `http://127.0.0.1:18789/healthz` 正常并核对实际 ws/wss 目标地址
1008 排查最小命令集
docker compose logs --since=30m openclaw-gateway | rg -n "1008|pairing required|unauthorized|token|invalid-request-frame"\nopenclaw pairing list feishu\nopenclaw devices list\ncurl -fsS http://127.0.0.1:18789/healthz3. 固化修复
修复后把“配置+验证”固化，降低回归概率。
- 固定网关地址/token 注入方式并写入模板
- 把 pairing 审批与健康检查加入上线清单
- 监控 1008 比例与相关日志关键字
常见问题
1008 一定是 token 错误吗？
不一定。社区案例显示 token、pairing 状态、协议帧不匹配都可能触发。
修复后多久可以验证稳定？
建议连续观察 24 小时请求日志，确认无新增 1008。