Openclaw 服务授权错误排查与修复
最近在使用 Windows 浏览器访问 Openclaw 聊天界面时，遇到了 unauthorized: gateway token mismatch 的错误提示。之前服务是正常运行的，这次突然无法连接，需要重新配置网关 Token。
故障现象
在客户端打开界面后，控制台或页面直接报错：
原因分析
这通常是因为服务器端（Ubuntu）的 Openclaw 进程状态异常，导致本地生成的 Token 与服务端缓存不一致。简单来说，就是服务端认为当前的认证凭证过期或无效了。
解决步骤
1. 检查并刷新配置
首先尝试通过 Ubuntu 服务器的终端访问本地配置页面。这一步能确认服务是否还在监听端口。
在 Ubuntu 的 Terminal 中输入以下命令，或者直接在浏览器地址栏输入：
# 确保服务正在运行
ps aux | grep openclaw
如果服务已启动，直接在 Firefox 浏览器中访问配置页：
进入该页面后，按照提示重新粘贴或生成 Token，通常就能恢复连接。
2. 强制重启服务
如果配置页面无法访问，或者修改 Token 后依然报错，说明进程可能卡死或内存状态异常。这时候需要彻底重启 Openclaw 进程。
查找进程 ID
使用 ps 或 pgrep 找到当前运行的进程：
# 方式一：查看所有进程并过滤
ps aux | grep openclaw
# 方式二：直接获取 PID
pgrep -a openclaw
终止进程
拿到 PID 后，使用 kill 命令结束它。如果普通终止无效，可以使用 -9 强制杀死：
# 替换 <PID> 为实际查到的进程号
kill <PID>
# 或者强制终止
kill -9 <PID>
# 也可以直接用名称终止，更省事
pkill openclaw
重新启动
回到项目目录并执行启动脚本：
# 进入项目根目录
cd /path/to/openclaw
# 启动服务
./openclaw
# 如果是全局安装，直接运行
openclaw
3. 一键重启脚本
为了方便后续维护，建议保存一个组合命令，既能清理旧进程又能快速拉起新服务：
# 终止旧进程 -> 等待 2 秒 -> 启动新进程
pkill openclaw && sleep 2 && /path/to/openclaw/openclaw
小贴士：
- 权限问题：如果执行
pkill或./openclaw提示 Permission denied，记得给脚本添加执行权限chmod +x ./openclaw。 - 端口占用：重启前确认 18789 端口没有被其他程序占用，否则新进程会启动失败。
- 日志查看：如果启动后立即退出，记得查看日志文件定位具体报错信息。
按上述步骤操作后，Windows 客户端应能正常连接 Openclaw 服务。
