彻底解决 OpenClaw “Gateway Connect Pairing Required” (1008) 错误：一键搞定配对问题

很多 OpenClaw 用户在尝试将网关连接到 Control UI 或仪表盘时，会反复看到“Disconnected (1008): pairing required”的提示。这个错误本质上是网关和客户端（浏览器或App）之间尚未完成设备授权配对。OpenClaw 出于安全考虑强制要求配对，当首次连接时，网关会检查客户端是否具备已批准的设备身份和有效令牌。如果缺少或未获批准，就会直接返回 1008 错误，导致仪表盘无法正常加载。

要恢复正常连接，只需完成配对和认证流程：把网关令牌提供给客户端，并批准待处理的配对请求。配对成功后，UI 就能稳定连接，不再出现该错误。

错误到底是什么意思

这个错误源于 OpenClaw 的安全设计。网关在接受 WebSocket 连接前，必须验证存在有效的令牌或已批准的设备身份。Control UI 运行在浏览器中，浏览器连接时会向网关发送自身的设备标识。如果网关从未批准过这个标识，就会以 1008 状态码拒绝连接。

最常见的触发场景包括：

• 没有有效网关令牌就直接访问仪表盘
• 在 Docker 环境下运行 OpenClaw，没有正确转发或信任本地网络请求头
• 重新安装应用、清除浏览器本地存储，导致已保存的令牌丢失

快速解决“需要配对”错误

下面是修复 1008 错误并成功连接网关的完整步骤。

获取并使用你的网关令牌

• 在主机上找到存储的令牌，通常位于~/.openclaw/openclaw.json或类似配置文件中。
• 也可以使用命令生成全新令牌，例如：openclaw doctor --generate-gateway-token
• 进入 Control UI 的仪表盘设置页面，将令牌粘贴进去并保存。
• 保存令牌后刷新仪表盘页面，重新尝试连接。

批准待处理的设备配对请求

• 使用 OpenClaw CLI 或容器命令查看待批准的配对请求。
• Docker 环境下的典型命令如下：

docker compose exec openclaw-gateway \
  node dist/index.js devices list

• 你会看到带有 ID 的待处理请求列表。
• 批准某个设备使用以下命令：

docker compose exec openclaw-gateway \
  node dist/index.js devices approve <ID>

• 批准完成后，仪表盘应该能立即正常连接，不再显示 1008 错误。

配置变更后重新配对

• 如果重新安装了浏览器应用或清除了存储，本地保存的设备身份会丢失。
• 这时需要重新配对：打开仪表盘，粘贴令牌，并在提示出现时批准新的设备请求。

检查网络和代理设置

• 在某些托管环境或使用反向代理时，请求到达网关的源地址可能被改变。
• 网关会认为这些是不受信任的来源，从而强制要求配对。
• 建议正确配置受信任代理，或者在合适场景下将网关绑定到 localhost，让客户端被识别为本地请求，直接接受令牌。

实用小技巧

• Docker 用户请尽量使用localhost:18789访问仪表盘，远程主机或非标准端口容易导致令牌验证失败。
• 修改配置后，建议重启网关服务：openclaw gateway restart
• 如果问题仍未解决，请查看网关日志，寻找设备不匹配或网络拒绝的相关提示。

总结

OpenClaw 通过存储设备凭证和配对令牌来保护远程访问安全。只有经过明确批准的客户端才能控制网关。这种配对机制也让终端 CLI 之外的节点或应用能够可靠运行。

只要正确完成配对和令牌配置，网关就能稳定连接，你将畅通无阻地使用 Control UI、查看日志、管理设备，再也不用反复面对配对提示。