OpenClaw 该跟哪个版本,怎么升级
小周把 OpenClaw 装在公司的一台小服务器上,跑得好好的,一个月没碰。某天群里有人转来一条消息:“OpenClaw 出了高危漏洞,赶紧升级。”他打开 GitHub,发现一周里发了好几个版本,还有一条叫 extended-stable 的线,一时不知道该升到哪个、升坏了怎么退回来。
这一课按真实顺序走一遍:
- 1?
- 2?
- 3?
- 4?
- 5?
- 6?
按先后顺序,一个一个点。
OpenClaw 有四个更新通道:stable、extended-stable、beta、dev。 大多数人跟 stable;想少折腾、长期跑在服务器上的,可以跟 extended-stable;beta 和 dev 是给想尝鲜和开发的人的。出了安全公告,就按公告里写的修复版本,在自己的通道里升到那一版或更新。
学完你能做什么
- 说清四个通道的区别,给自己的机器选一个
- 读懂一条 OpenClaw 安全公告,判断自己受不受影响
- 用
openclaw update预演、升级、验证,必要时回滚
先处理眼前这条公告
2026-11-19,OpenClaw 发布了高危公告 GHSA-pw3x-g8v8-fvj2(CVSS 8.8)。它影响本教程的基准版本 2026.10.9,所以先把结论放在这里:
| 公告里的字段 | 内容 |
|---|---|
| 标题 | OpenClaw delegation could skip approval for restricted agents |
| 问题 | 工具策略禁止执行命令和写文件时,openclaw 工具仍可能不经审批写入持久配置,受限 agent 借此可以打开主机命令执行 |
| 受影响版本 | ≥ 2026.9.2 且 < 2026.10.33;≥ 2026.11.1 且 < 2026.11.4 |
| 修复版本 | stable 第一个修复版是 2026.11.4;extended-stable 用户升到 2026.10.33 |
| 升级前的缓解 | 把 tools.exec.mode 设为 ask,拒绝不可信的委托改动 |
公告原文:https://github.com/openclaw/openclaw/security/advisories/GHSA-pw3x-g8v8-fvj2。OpenClaw 的所有安全公告都在仓库的 Security → Advisories 页面:https://github.com/openclaw/openclaw/security/advisories。
查一查我现在的版本是……
点一个看看。
公告里有一句容易漏看:这条漏洞“不改变 OpenClaw 的信任模型”,影响有多大取决于你的配置,以及低信任的输入能不能走到这条路径。也就是说,只有你一个人用、没接外部渠道的 Gateway 风险更低,但仍然应该升级。
- 我用
openclaw --version看过自己的版本,知道受不受影响
四个通道有什么区别
官方文档对四个通道的定义:
| 通道 | 对应 npm 标签 | 说明 |
|---|---|---|
| stable | latest | 推荐大多数用户使用 |
| extended-stable | extended-stable | 官方原文是 “trailing supported-month package channel”,即落后于最新版、按月维护的版本线;只支持包安装(npm 等),不支持 git 安装;安装只能在前台进行;开了 update.checkOnStart 时只给只读的更新提示,从不自动安装 |
| beta | beta | 取 beta 和 latest 里版本号更新的那个;旧的 beta 不会替换更新的 stable |
| dev | 无(git 的 main 分支) | 可能有未完成的功能或破坏性变更,不要用在生产 Gateway 上 |
extended-stable 的定位,在 2026.10.33 的发布说明里写得最直白:“gateway-only extended-stable release, which is our current equivalent to LTS”。它是 10 月底的 OpenClaw,加上关键安全修复、可靠性与性能修复和新模型支持。它只发 Gateway:npm 核心包、配套的官方 npm 插件和 Gateway Docker 镜像,不含原生 App。版本号上,extended-stable 用每月 33 及以上的补丁号(如 2026.9.33 ~ 2026.9.37、2026.10.33),和 stable 的编号分开。
截至 2026-11-20,三条线的最新版本:
| 通道 | 版本 | 日期 |
|---|---|---|
| stable | 2026.11.6 | 2026-11-19 |
| extended-stable | 2026.10.33 | 2026-11-18 |
| beta | 2026.11.10-beta.1 | 2026-11-19 |
考考你小周的 OpenClaw 用 npm 装在服务器上,只跑 Gateway,不想每周跟着改动,但安全修复一个都不想漏。哪个通道更合适?
- 我选好了自己要跟的通道
第 1 步:查清现在的版本和通道
为什么:升级前要知道起点,尤其是 Gateway 服务实际跑的是哪个安装。
openclaw --version
openclaw update status你应该看到:第一条打印 CLI 的版本号。第二条显示当前通道和决定它的来源(配置、git tag、git 分支、已装版本或默认值)、安装方式(git 还是包安装)、当前版本,以及有没有可用更新。
官方的升级前检查还提醒:openclaw --version 报的是命令行的版本,Gateway 服务可能指向另一个安装。用 openclaw status 和 openclaw gateway status --deep 再核对一遍。
- 我知道自己的版本、通道和安装方式
第 2 步:没法马上升级时,先做临时缓解
为什么:公告给出的缓解办法是让执行走人工确认,在升级前先堵住最危险的路径。
在 ~/.openclaw/openclaw.json 里:
{
tools: {
exec: { mode: "ask" },
},
}改完重启 Gateway。这只是缓解,公告的第一条建议仍然是升级。
- 暂时不能升级的机器,我已经把
tools.exec.mode设成ask
第 3 步:备份,然后预演
为什么:官方文档说,openclaw update 自动保存的只是升级前的配置副本,不是完整状态。降级也不会撤销配置和数据库的迁移,真要退回旧版,靠的是一份升级前的备份。
mkdir -p ~/Backups/openclaw
openclaw backup create --output ~/Backups/openclaw --verify你应该看到:备份目录里多出一个归档文件。归档里可能有凭据和渠道状态,要像保护 ~/.openclaw 一样保护它。
然后预演,看它打算做什么:
openclaw update --channel stable --dry-run
# 想跟 extended-stable 的改成:
openclaw update --channel extended-stable --dry-run你应该看到:报告里有生效的通道、目标版本、计划执行的动作,以及是否需要降级确认。--dry-run 不改动任何东西。
- 我有一份带
--verify的备份,也看过预演结果
第 4 步:升级并验证
为什么:--channel 会执行升级,并在核心升级成功后把选择写进配置的 update.channel,以后直接 openclaw update 就沿用这条线。
openclaw update --channel stable
# 或
openclaw update --channel extended-stable你应该看到:升级完成。对受管的 Gateway 服务,切换成功后会刷新服务并检查就绪;如果切换被拒绝或验证后回滚,会恢复之前的服务。
再核对一遍:
openclaw --version
openclaw gateway status --deep你应该看到:版本号是 2026.11.4 或更新(stable),或 2026.10.33(extended-stable)。
几个要注意的地方:
git 安装不能用 extended-stable。OpenClaw 会保持原样,让你改用包安装。
从 2026.11.1 ~ 11.3 切到 extended-stable 2026.10.33,按版本号是降级,会弹出降级确认。降级不会撤销已经发生的迁移,这种情况跟 stable 升到 2026.11.4 以上更稳。
只想一次性装某个版本、不改通道,用
--tag,例如官方文档里的openclaw update --tag 2026.4.1-beta.1。--tag只对 npm 包安装有效,git 安装会忽略它。openclaw --version显示的版本已经不在受影响范围内
第 5 步:出问题时回滚
为什么:新版本有时会和你的环境冲突。官方推荐用 openclaw update 回滚,而不是手动 npm i -g 覆盖,因为后者不会保留上一个包,也不跑恢复流程。
openclaw update --tag <已知可用的版本> --dry-run
openclaw update --tag <已知可用的版本>更新器会检查兼容性,并要求你确认降级。如果你保存的通道是 extended-stable,官方文档说要加上 --channel stable 才能指定确切的版本。
你应该看到:服务重启,运行版本变回你指定的那一版。如果旧版本读不了当前的状态,更新器会拒绝,这时要用第 3 步的备份连同对应的旧版本一起恢复。不要绕过“新版本写入的配置或数据库”这类拒绝。
还有两个兜底:
- 新激活的包验证失败时,
openclaw update在满足条件时会自动回滚到上一个版本。2026.11.5 起,Doctor 或 Gateway 启动失败也会回滚已激活的更新。 - 卡住了,在 Gateway 所在的机器上运行
openclaw triage,它会把诊断信息交给本机的编程 agent 帮你修。
回滚别回到受影响的版本
因为 GHSA-pw3x 回滚时,目标版本要选 2026.11.4 以上或 2026.10.33。回到 2026.10.9 就等于把漏洞装了回去。
- 我记下了一个“已知可用、且不受公告影响”的版本号
检查点
- 我能说出 stable 和 extended-stable 的两条区别(比如更新节奏、是否含原生 App)
- 我能从一条公告里找到受影响版本、修复版本和临时缓解
- 我的 Gateway 已经升到 2026.11.4 以上或 2026.10.33
- 我知道升级前要先
openclaw backup create --verify,再--dry-run
常见误会
以为 extended-stable 会自己更新。 它从不自动安装,最多在启动检查时给提示。跟这条线的人,要自己定期看公告、手动运行 openclaw update。
以为降级能撤销一切。 官方文档写明,降级包不会撤销配置和数据库迁移。状态已经迁移到旧版读不了的格式时,唯一支持的办法是恢复升级前的备份。
以为 beta 比 stable 更“新”就更安全。 beta 是候选版本,安全修复会进 stable 和 extended-stable。生产环境用 stable 或 extended-stable;dev 官方明确说不要用在生产 Gateway 上。
下一节
常用命令和配置项都汇总在CLI 命令与配置速查,各版本的变化见更新日志。