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 扩展

1. Gateway URL: http://127.0.0.1:18789
2. Token: 与配置文件中一致的 token

常用命令速查

openclaw gateway status
openclaw gateway start
openclaw gateway stop
openclaw gateway restart

总结

Gateway token 不匹配是 OpenClaw Chrome 扩展连接失败的常见原因。关键是要确保配置文件中的 token 与扩展中配置的一致，更新 token 后要完全重启 Gateway 服务。

参考文档：OpenClaw 官方文档