今天将OpenClaw升级到了最新的2026.04.09版本,在此记录升级后遇到的主要变化和关键注意事项,帮助大家顺利完成配置迁移。
首先,请通过命令行确认版本号是否更新成功:
PS C:\Users\xxxxxx> openclaw --version
OpenClaw 2026.4.9 (0512059)
确认版本无误后,我们来看本次更新的几个核心变化。
1. Gateway默认端口号变更
第一个重要变更是Gateway服务的默认访问端口。旧版本默认使用的18789端口已调整为18790。如果您仍使用旧地址访问管理界面,将会连接失败。请更新您的访问地址为:
http://127.0.0.1:18790/
建议将此新地址加入浏览器书签,以便后续快速访问。
2. 登录Token重置与找回方法
第二个关键变化,也是升级后最常见的登录问题:网关认证Token已被重置。登录管理界面时,系统会要求输入新的Token,而旧Token已失效。
无需担心,新的Token已自动生成并保存在本地配置中。请按以下步骤找回并配置:
-
定位并打开OpenClaw的配置文件。其默认路径通常为:
.openclaw\openclaw.json。 -
在配置文件中,找到
gateway配置节点。展开后,其结构示例如下:
"gateway": {
"port": 18790,
"mode": "local",
"bind": "loopback",
"controlUi": {
"allowedOrigins": ["*"]
},
"auth": {
"token": "拷贝这个编码,填到登录页面的网关Token字段里面去"
},
"tailscale": {
"mode": "off",
"resetOnExit": false
}
},
- 关键操作:复制
auth对象内token字段的值(即一长串编码字符串)。 - 返回OpenClaw登录页面(地址为
http://127.0.0.1:18790/),将复制的Token粘贴至“网关Token”输入框,点击登录即可完成认证。
总结来说,本次OpenClaw版本升级主要涉及默认端口变更和登录凭证的更新。按照上述步骤操作,即可快速完成配置适配,恢复服务正常使用。
