OpenClaw Gateway Token 问题排查记录

问题时间: 2026-03-04
问题描述: TUI 窗口无法打开，提示 gateway connect failed: Error: unauthorized: gateway token mismatch

---

问题现象

1. TUI/WebUI 连接 Gateway 时报错：gateway token mismatch
2. Gateway 服务状态不稳定，有时运行有时停止

排查过程

第一步：检查 Gateway 状态

openclaw gateway status

发现 Gateway 服务已停止（昨天 22:59 就停止了）。

第二步：重启 Gateway

openclaw gateway start

重启后服务运行，但 TUI 仍然报错。

第三步：检查环境变量

发现系统环境变量中设置了 OPENCLAW_GATEWAY_TOKEN:

OPENCLAW_GATEWAY_TOKEN=9b7f6b2ce4e80c307aac1f7da534e14dab2b07d9d2f8ec87

但 TUI 客户端没有配置这个 token，导致认证失败。

第四步：尝试禁用 Token 认证

尝试用 --auth none 前台运行：

openclaw gateway run --auth none

但由于旧进程占用端口，未成功。

第五步：清除环境变量

确认该 Token 无其他用途后，执行清除：

reg delete "HKCU\Environment" /v OPENCLAW_GATEWAY_TOKEN /f

第六步：彻底清理旧进程

发现旧 Gateway 进程（PID 17564）仍在运行并使用 token 认证：

taskkill /F /PID 17564
openclaw gateway start

---

问题根因

1. 系统环境变量中设置了 OPENCLAW_GATEWAY_TOKEN
2. Gateway 服务使用该 Token 进行认证
3. TUI 客户端（openclaw-control-ui）没有配置对应的 token
4. 之前可能手动设置过该环境变量，后来遗忘了

---

解决方案

方案一（推荐）：清除环境变量

reg delete "HKCU\Environment" /v OPENCLAW_GATEWAY_TOKEN /f

然后重启 Gateway 服务。

方案二：配置一致的 Token

如果需要 Token 认证，需要在 TUI 客户端配置中添加对应的 token。

---

预防措施

1. 避免在系统环境变量中手动设置 OpenClaw 相关 Token
2. 使用配置文件或官方配置方式管理认证
3. 定期检查 Gateway 服务状态

---

相关命令速查

命令	说明
openclaw gateway status	查看 Gateway 状态
openclaw gateway start	启动 Gateway
openclaw gateway stop	停止 Gateway
netstat -ano | findstr 18789	查看端口占用
taskkill /F /PID <PID>	强制结束进程

---

记录时间: 2026-03-04 08:40