部署 OpenClawClawdBot、MoltBot后访问localhost:18789报 1008 错误怎么办很多朋友部署完 OpenClaw原 ClawdBot/MoltBot后兴冲冲打开浏览器访问http://localhost:18789结果直接撞见Plain Textdisconnected (1008): unauthorized: gateway token mismatch或Plain Textdisconnected (1008): pairing required控制台连不上、页面空白、服务明明在跑却一直报错。别急这是OpenClaw 最经典的高频坑不是部署失败而是认证 / Token / 端口 / 配置四类问题。下面从原理到根治一步步带你彻底解决。一、先搞懂1008 错误到底是什么1. 错误本质1008 WebSocket 连接被网关拒绝认证失败。OpenClaw Gateway网关默认开启Token 强认证浏览器访问控制台必须携带与网关完全一致的 Token没有 Token、Token 错误、Token 过期、设备未配对 → 直接断开并返回 1008。2. 常见两种 1008token mismatchToken 对不上最常见pairing required设备未授权配对Docker / 远程访问常见3. 为什么直接访问localhost:18789会报错直接输地址 →不带 Token→ 被拦截Gateway 重启会自动刷新 Token浏览器缓存旧 Token → mismatchDocker 环境下localhost被识别为外部网络 → 触发配对校验。二、7 步快速排查从易到难优先做✅ 第一步用官方命令打开控制台90% 人卡在这不要手动输地址终端执行bash# 1. 查看网关状态确认runningopenclaw gateway status# 2. 一键获取带Token的访问链接核心openclaw dashboard终端会输出完整带 Token 的 URL类似Plain Texthttp://localhost:18789/?tokenxxxxxxxxxxxxxxxxxxxx复制这个完整链接到浏览器打开不要删减、不要只输 IP 端口。✅ 第二步确认 Gateway 正常运行bashopenclaw gateway status正确输出Plain TextRuntime: runningRPC probe: successPort: 18789如果显示stopped或端口异常bash# 重启网关openclaw gateway restart# 端口被占用时先释放lsof -i :18789kill -9 占用PID✅ 第三步手动拿最新 Token解决 mismatchbash# 直接输出当前有效Tokenopenclaw gateway token拿到 Token 后手动拼接 URLPlain Texthttp://127.0.0.1:18789/?token你的最新Token✅ 第四步清除浏览器缓存 / 换无痕模式浏览器缓存了旧 Token直接访问会自动带旧值 → 1008解决无痕模式打开或清除localhost:18789缓存。✅ 第五步Docker 环境专属修复pairing requiredDocker DesktopmacOS/Windows下localhost被识别为外部 IP触发配对bash# 1. 进入容器docker exec -it openclaw-openclaw-gateway-1 /bin/bash# 2. 写入本地模式配置关闭配对mkdir -p /home/node/.openclawcat /home/node/.openclaw/openclaw.json EOF{gateway: {mode: local,bind: 0.0.0.0,port: 18789,auth: {mode: token}}}EOF# 3. 重启容器docker restart openclaw✅ 第六步修改配置为本地信任模式根治编辑配置文件~/.openclaw/openclaw.jsonjson{gateway: {mode: local, // 本地模式信任localhostbind: 127.0.0.1,port: 18789,auth: {mode: token // 仅Token认证关闭配对}}}保存后重启bashopenclaw gateway restart✅ 第七步终极诊断仍不行时bash# 一键修复常见问题openclaw doctor --fix# 实时看日志抓错误openclaw logs -f | grep -i token\|auth\|error\|1008三、避坑关键为什么你总是 1008不要手动拼 URL必须用openclaw dashboard输出的完整链接重启必换 Token每次gateway restart后旧链接直接失效Docker 别用localhost优先用127.0.0.1或容器 IP端口别乱改默认 18789改端口会导致认证异常不要删配置文件~/.openclaw/删了会重置 Token 和模式。四、总结一句话根治1008Token 不对或模式不对。优先用openclaw dashboard拿带 Token 的链接Docker 切本地模式重启后必更新链接无痕模式打开。99% 的情况都能解决。要不要我把以上步骤整理成一份可直接复制的一键修复脚本你直接运行就能解决 1008 错误