jvs claw连接失败主要因设备未授权、websocket url错误、网关未运行或token不匹配。需依次检查并处理：①用clawdbot devices list查看pending设备并approve；②确保url为完整ws/wss地址含token；③运行openclaw gateway run启动网关并curl验证；④核对openclaw.json中gateway.auth.token与remote.token一致；⑤排查前端js加载异常，清除缓存或禁用广告拦截插件。
JVS Claw连接失败时，前端界面常显示“模型不可用”、长时间加载无响应或点击“连接”按钮毫无反应，这类问题多由设备未授权、WebSocket URL填写错误、网关服务未启动或Token不匹配导致。
检查设备是否已授权
新设备首次连接JVS Claw必须完成显式授权，否则始终处于pending状态无法通信。
执行命令查看待处理请求：clawdbot devices list
若输出中存在 【Device ID: xxxx-xxxx-xxxx (Requested at: ...) 且状态为Pending，则需手动批准。
运行命令批准请求：clawdbot devices approve [request_id]，其中[request_id]为上一步输出中的完整Device ID。
再次执行clawdbot devices list，确认目标设备状态已变为【active】。未出现active状态则授权未生效，需检查/app/clawdbot.json权限是否为644。
验证WebSocket URL格式是否正确
OpenClaw仪表盘的“连接”按钮无响应，90%以上情况是填入了不完整的URL——只粘贴了token参数，而非带token的完整WebSocket地址。
方法一：使用命令自动生成有效URL
在终端运行clawdbot dashboard，系统会自动打开浏览器并跳转至含有效token的Dashboard页面；此时地址栏URL即为合法WebSocket入口，可直接复制使用。
方法二：手动构造URL
基础格式必须为ws://localhost:18789/ws?token=xxxxxxxxxx或wss://your-domain.com/ws?token=xxxxxxxxxx；【不能只填token=xxx或http://开头的地址】。
方法三：从配置文件提取
打开~/.openclaw/openclaw.json，定位gateway.remote.url字段值，该值应为完整URL，末尾已含?token=...参数。
确认网关服务正在运行
第一步：检查网关进程是否存活
运行openclaw gateway status，若返回inactive或无输出，说明网关未启动。
第二步：启动网关
执行openclaw gateway run。默认监听端口为18789，若被占用，可在配置中修改gateway.port后重启。
第三步：验证端口可达性
在另一终端执行curl -v http://localhost:18789/health，返回HTTP 200表示服务已就绪；若超时或拒绝连接，说明网关未监听或防火墙拦截。
注意：Docker部署用户需额外确认容器状态，运行docker ps | grep clawdbot，确保容器状态为Up，否则执行docker restart clawdbot_container。
核对Token是否一致
当控制台报错disconnected (1008): unauthorized: gateway token mismatch，说明客户端与服务端Token不一致。
① 打开~/.openclaw/openclaw.json，找到gateway.auth.token和gateway.remote.token两个字段。
② 对比二者值是否完全相同（包括大小写、符号、空格）；【任何一处字符差异都会触发1008错误】。
③ 若不同，执行命令同步：openclaw config set gateway.remote.token "your-auth-token-here"，引号内填gateway.auth.token的实际值。
④ 重启网关：openclaw gateway restart，使新配置生效。
排查前端脚本加载异常
点击“连接”按钮无任何反应（无报错、无加载动画），大概率是前端JavaScript未执行。
按F12打开浏览器开发者工具 → 切换到Console标签页 → 点击“连接”按钮，观察是否有红色报错信息。
若出现Uncaught ReferenceError: clawdbot is not defined等错误，说明页面资源加载失败；此时应清除浏览器缓存或使用无痕模式重试。
禁用uBlock Origin、AdGuard等脚本拦截插件，这些工具可能误杀OpenClaw前端必需的JS文件。
