OpenClaw Gateway 与 Chrome 扩展故障排除实录
问题背景
最近在使用 OpenClaw 的 Chrome 扩展 "Browser Relay" 时,遇到了连接失败的问题,扩展图标一直显示叹号,提示:
Gateway token rejected. Check token and save again. 经过一番排查,发现是 Gateway token 不匹配导致的问题。本文记录完整的排查和解决过程。
环境信息
- 操作系统:Windows 10
- OpenClaw 版本:2026.2.22-2
- Chrome 扩展:OpenClaw Browser Relay
问题诊断
1. 检查 Gateway 状态
首先检查 Gateway 服务状态:
openclaw gateway status 输出结果:
Runtime: running RPC probe: failed gateway closed (1008): unauthorized: gateway token mismatch Port 18789 is already in use. 2. 检查端口占用
查看 18789 端口占用情况:
netstat -ano | findstr "18789" 3. 检查配置文件
配置文件位置:%OPENCLAW_HOME%.openclawopenclaw.json
解决方案
步骤 1:生成新的 Token
$bytes = New-Object byte[] 24 [Security.Cryptography.RandomNumberGenerator]::Create().GetBytes($bytes) $newToken = [BitConverter]::ToString($bytes).Replace('-','').ToLower() 步骤 2:更新配置文件
编辑 openclaw.json,将新 token 更新到 gateway.auth.token 字段。
步骤 3:重启 Gateway 服务
openclaw gateway stop taskkill /F /PID <进程ID> openclaw gateway start 步骤 4:配置 Chrome 扩展
- Gateway URL:
http://127.0.0.1:18789 - Token: 与配置文件中一致的 token
常用命令速查
openclaw gateway status openclaw gateway start openclaw gateway stop openclaw gateway restart 总结
Gateway token 不匹配是 OpenClaw Chrome 扩展连接失败的常见原因。关键是要确保配置文件中的 token 与扩展中配置的一致,更新 token 后要完全重启 Gateway 服务。
参考文档:OpenClaw 官方文档