QClaw部署后访问异常怎么办_QClaw访问问题解决办法【解答】

苏承栈

2026-10-10 • 👁 0人浏览过

QClaw控制台访问异常需依次排查：一、重启网关服务；二、将配置中bind改为"lan"或"0.0.0.0"；三、生成并填入gateway token；四、在allowedOrigins中添加对应源；五、完成微信绑定。

如果您成功部署qclaw后，在浏览器中访问http://localhost:18789或局域网地址时出现空白页、连接失败、跨域错误或红色提示（如disconnected (1008): unauthorized: gateway token missing），说明网关服务虽已运行，但控制台访问链路存在授权、监听或来源限制问题。以下是解决该类访问异常的多种标准方法：

一、验证并重启 QClaw Gateway 服务

服务未真正启动或处于异常挂起状态，会导致端口无响应或返回空内容。需确认进程活跃性并强制刷新上下文。

1、在终端执行命令查看当前运行状态：

openclaw gateway status 2、若显示 inactive 或 unknown，则执行重启：openclaw gateway restart

3、等待约5秒后，再次访问

http://localhost:18789观察是否恢复基础加载界面。

二、检查并修正网关监听地址绑定模式

默认配置可能仅绑定到

127.0.0.1

，导致局域网其他设备无法访问，或本地访问时因代理/容器环境产生路径错位。

1、打开 QClaw 配置文件：sudovi ~/.openclaw/openclaw.json

2、定位到

"gateway"节点，确认"bind"字段值为"lan"或"0.0.0.0"；若为"local"

，请修改为：

"bind": "lan"

3、保存文件后执行：

openclaw gateway restart

三、注入有效 Gateway Token 并完成授权初始化

QClaw 控制台强制校验 WebSocket 连接令牌，缺失或过期 token 将直接触发 1008 错误，页面无法建立会话。

1、在终端运行以下命令生成新 token：openclaw gateway token --generate 2、复制输出的完整 token 字符串（形如gwtk_abc123def456...

）

3、访问

http://localhost:18789，在 Control UI 设置页（通常为右上角齿轮图标）粘贴该 token 并保存。

Qclaw腾讯电脑管家打造的桌面智能体AI助手，随时随地，微信一下，Qclaw帮你搞定一切下载

4、刷新页面，此时应跳转至主控台或显示正常连接状态。

四、配置 allowedOrigins 白名单以解除跨域拦截

当从非 localhost 地址（如http://192.168.1.100:18789）访问时，浏览器因同源策略拒绝加载资源，报错提示origin not allowed。

1、编辑配置文件：

sudovi ~/.openclaw/openclaw.json

2、在

"gateway"

节点下添加字段：

"controlUi": {"allowedOrigins": ["*"]}

3、若仅需允许特定地址，可替换为数组形式：

"allowedOrigins": ["http://localhost:18789", "http://192.168.1.100:18789"]

4、保存后重启服务：