Skip to content
🔧 进阶手册第 8 / 8 节

OpenClaw 该跟哪个版本,怎么升级 ​

小周把 OpenClaw 装在公司的一台小服务器上,跑得好好的,一个月没碰。某天群里有人转来一条消息:“OpenClaw 出了高危漏洞,赶紧升级。”他打开 GitHub,发现一周里发了好几个版本,还有一条叫 extended-stable 的线,一时不知道该升到哪个、升坏了怎么退回来。

这一课按真实顺序走一遍:

排一排一次安全升级的顺序
  1. 1?
  2. 2?
  3. 3?
  4. 4?
  5. 5?
  6. 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 标签说明
stablelatest推荐大多数用户使用
extended-stableextended-stable官方原文是 “trailing supported-month package channel”,即落后于最新版、按月维护的版本线;只支持包安装(npm 等),不支持 git 安装;安装只能在前台进行;开了 update.checkOnStart 时只给只读的更新提示,从不自动安装
betabeta取 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,三条线的最新版本:

通道版本日期
stable2026.11.62026-11-19
extended-stable2026.10.332026-11-18
beta2026.11.10-beta.12026-11-19

考考你小周的 OpenClaw 用 npm 装在服务器上,只跑 Gateway,不想每周跟着改动,但安全修复一个都不想漏。哪个通道更合适?

  • 我选好了自己要跟的通道

第 1 步:查清现在的版本和通道 ​

为什么:升级前要知道起点,尤其是 Gateway 服务实际跑的是哪个安装。

bash
openclaw --version
openclaw update status

你应该看到:第一条打印 CLI 的版本号。第二条显示当前通道和决定它的来源(配置、git tag、git 分支、已装版本或默认值)、安装方式(git 还是包安装)、当前版本,以及有没有可用更新。

官方的升级前检查还提醒:openclaw --version 报的是命令行的版本,Gateway 服务可能指向另一个安装。用 openclaw status 和 openclaw gateway status --deep 再核对一遍。

  • 我知道自己的版本、通道和安装方式

第 2 步:没法马上升级时,先做临时缓解 ​

为什么:公告给出的缓解办法是让执行走人工确认,在升级前先堵住最危险的路径。

在 ~/.openclaw/openclaw.json 里:

json5
{
  tools: {
    exec: { mode: "ask" },
  },
}

改完重启 Gateway。这只是缓解,公告的第一条建议仍然是升级。

  • 暂时不能升级的机器,我已经把 tools.exec.mode 设成 ask

第 3 步:备份,然后预演 ​

为什么:官方文档说,openclaw update 自动保存的只是升级前的配置副本,不是完整状态。降级也不会撤销配置和数据库的迁移,真要退回旧版,靠的是一份升级前的备份。

bash
mkdir -p ~/Backups/openclaw
openclaw backup create --output ~/Backups/openclaw --verify

你应该看到:备份目录里多出一个归档文件。归档里可能有凭据和渠道状态,要像保护 ~/.openclaw 一样保护它。

然后预演,看它打算做什么:

bash
openclaw update --channel stable --dry-run
# 想跟 extended-stable 的改成:
openclaw update --channel extended-stable --dry-run

你应该看到:报告里有生效的通道、目标版本、计划执行的动作,以及是否需要降级确认。--dry-run 不改动任何东西。

  • 我有一份带 --verify 的备份,也看过预演结果

第 4 步:升级并验证 ​

为什么:--channel 会执行升级,并在核心升级成功后把选择写进配置的 update.channel,以后直接 openclaw update 就沿用这条线。

bash
openclaw update --channel stable
# 或
openclaw update --channel extended-stable

你应该看到:升级完成。对受管的 Gateway 服务,切换成功后会刷新服务并检查就绪;如果切换被拒绝或验证后回滚,会恢复之前的服务。

再核对一遍:

bash
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 覆盖,因为后者不会保留上一个包,也不跑恢复流程。

bash
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 命令与配置速查,各版本的变化见更新日志。

搞懂AI关于我们怎么写隐私说明联系我们

独立的第三方教程,与文中提到的任何产品及其公司没有隶属或合作关系;产品名称和商标归各自所有者。价格和政策以官方页面为准。