OpenClaw升级4.9版本常见问题与解决方法

今天将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已自动生成并保存在本地配置中。请按以下步骤找回并配置：

1. 定位并打开OpenClaw的配置文件。其默认路径通常为：.openclaw\openclaw.json。

2. 在配置文件中，找到gateway配置节点。展开后，其结构示例如下：

"gateway": {
  "port": 18790,
  "mode": "local",
  "bind": "loopback",
  "controlUi": {
    "allowedOrigins": ["*"]
  },
  "auth": {
    "token": "拷贝这个编码，填到登录页面的网关Token字段里面去"
  },
  "tailscale": {
    "mode": "off",
    "resetOnExit": false
  }
},

3. 关键操作：复制auth对象内token字段的值（即一长串编码字符串）。
4. 返回OpenClaw登录页面（地址为http://127.0.0.1:18790/），将复制的Token粘贴至“网关Token”输入框，点击登录即可完成认证。

总结来说，本次OpenClaw版本升级主要涉及默认端口变更和登录凭证的更新。按照上述步骤操作，即可快速完成配置适配，恢复服务正常使用。