☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
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 并保存。
自动备份 OpenClaw 整体配置到远程存储（支持任意 rclone 后端：COS、S3、FTP、SFTP、WebDAV等）。 触发场景： - 创建/配置自动备份任务 - 设置备份周期、保留份数、目标目录 - 手动触发备份 - 查看/恢复备份 - OpenClaw 运行异常时的提醒
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、保存后重启服务：
openclaw gateway restart
五、确认微信绑定已完成且客户端处于激活态
QClaw 的部分 UI 功能（尤其是任务面板与远程指令入口）依赖微信会话通道初始化，未完成绑定将导致控制台功能模块静默失效或加载中断。
1、启动 QClaw 客户端，观察左下角是否弹出微信扫码窗口；若未弹出，手动点击界面左下角「微信绑定」按钮。
2、使用微信扫描二维码，并在手机端确认授权。
3、绑定成功后，客户端右上角应显示绿色在线标识，此时重新访问 http://localhost:18789 可加载完整功能界面。
