OpenClaw 在 Windows 与 Linux 系统的部署实战

四、浏览器访问与测试

1. 连接界面

在浏览器打开拼接好 Token 的地址。如果显示'已连接'，说明网关正常启动。

2. 功能测试

尝试输入指令，例如：'创建一个 readme.txt'。观察 AI 是否能在本地文件系统生成文件。

3. 验证结果

检查文件是否存在，确保 AI 拥有正确的读写权限。

五、常见问题排查

1. Nginx 反向代理配置

如果需要对外提供服务，可通过 Nginx 转发到本地 18789 端口。

Nginx 配置示例：

server {
    listen 80;
    server_name your-domain.com;
    location / {
        proxy_pass http://127.0.0.1:18789;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 86400;
    }
}

OpenClaw 配置调整： 编辑 ~/.openclaw/openclaw.json，增加信任代理配置：

{
  "gateway": {
    "bind": "loopback",
    "port": 18789,
    "trustedProxies": ["127.0.0.1"],
    "auth": {
      "mode": "token",
      "token": "your-secure-token-here"
    }
  }
}

重启服务：openclaw-cn gateway

2. Web UI 显示 'disconnected (1008): pairing required'

这通常是因为安全认证限制。执行以下命令允许不安全认证：

• 原版：

  openclaw config set gateway.controlUi.allowInsecureAuth true
  openclaw gateway restart
  

• 汉化版：

  openclaw-cn config set gateway.controlUi.allowInsecureAuth true
  openclaw-cn gateway restart
  

3. HTTPS 错误提示

若出现 control ui requires HTTPS or localhost，请确保 Nginx 已配置有效的 SSL 证书。

4. Token 不匹配

若报错 unauthorized: gateway token mismatch，请重新检查 ~/.openclaw/openclaw.json 中的 token 值是否与浏览器地址栏一致。