解决 OpenClaw WebUI 报错 disconnected (1008): pairing required

方法一：后台手动批准（命令行模式）#

如果您能访问服务器终端，这是最直接的方法。通过手动批准待处理的配对请求来建立信任。

1. 查看待处理请求：

   1
   openclaw devices list

2. 批准请求： 找到对应的 request id 后运行：

   1
   openclaw devices approve <request id>

方法二：信任反向代理（推荐配置）#

修改服务器上的 ~/.openclaw/openclaw.json，在 gateway 配置段中加入 trustedProxies。这告诉 Gateway，Nginx 转发过来的流量是“自己人”。

1
"gateway": {
2
  "trustedProxies": ["127.0.0.1"],
3
  ...
4
}

方法三：修改配置文件强制放行（最彻底/暴力）#

如果上述方法依然无效（通常是由于手机浏览器缓存或 Nginx 头部透传问题），可以强制允许非安全环境下的身份验证。在 gateway 配置段中添加 controlUi 项。

1
"gateway": {
2
  "controlUi": {
3
    "allowInsecureAuth": true
4
  },
5
  "auth": {
6
    "mode": "token",
7
    "token": "你的TOKEN",
8
    "pairing": "off"
9
  }
10
}