24. 升级与版本管理：保持 OpenClaw 最新

本节目标：学会怎么把 OpenClaw 升到最新，看懂版本号和更新通道，并知道什么时候该回退、为什么回退要慎重。

OpenClaw 迭代很快。保持在较新版本，能拿到修复和安全补丁。这一章把”升级”这件事讲透，不让你升坏了，也不让你不敢升。

Note

本书基于 2026.7.1-2（npm latest）撰写。截至写作时，扩展稳定版是 2026.6.33，beta 是 2026.7.2-beta.4。版本号会动，动手前可先 openclaw update status 看一眼。

怎么升级：两条路

如果你是用 npm 全局装的（最常见），直接重装最新版：

npm install -g openclaw@latest

装完重启网关服务让新代码生效：

openclaw gateway restart

如果你不想记 npm 命令，也可以用内置的更新命令，它会处理通道切换、插件同步和服务重启：

openclaw update
openclaw update --dry-run

--dry-run 只预览”要做什么”，不改任何东西，适合升级前心里有数。

Tip

升级后若发现渠道空了、网关起不来，先 openclaw doctor --fix 再 openclaw gateway restart。多数”升级后突然坏”都是配置漂移，doctor 能修掉大部分。

版本号到底什么意思

OpenClaw 用”年月日”风格的版本号：YYYY.M.PATCH。

2026.7.1 表示 2026 年 7 月的常规发布，补丁号 1。
补丁号 小于 33 的常规版走 latest 通道。
补丁号 大于等于 33（如 2026.6.33）属于”扩展稳定线”，走 extended-stable 通道。
beta 形如 2026.7.2-beta.4，alpha 形如 2026.5.19-alpha.1。

月份和补丁号都不补零。补丁号是”当月发布序号”，不是日历日期。

四个更新通道

OpenClaw 有四个通道，官方建议绝大多数人选 stable：

通道	含义	适合谁
`stable`	npm `latest`，常规稳定版	绝大多数人
`extended-stable`	上月完整维护线（`.33+`）	求稳、不想频繁动
`beta`	预发布，缺或比稳定版旧时回退 `latest`	想尝鲜、帮测
`dev`	`main` 分支移动头，可能含破坏性改动	开发者，别上生产

切换通道并持久化：

openclaw update --channel stable
openclaw update --channel extended-stable
openclaw update --channel beta

只想这一次装某个具体版本，不改动持久通道：

openclaw update --tag 2026.4.1-beta.1

Note

--tag 只对 npm 安装生效，git 安装会忽略它。回退到更老版本时，OpenClaw 会要求你确认（用 --yes 跳过确认）。

extended-stable 是什么

扩展稳定版（extended-stable）是”上个月那一条完整维护线”。它只发 npm 包，安装和更新都是前台进行；选定后，若开启 update.checkOnStart，只会收到只读的更新提示，绝不会自动应用。

它的好处是：少动。你装了 2026.6.x 的扩展稳定线，日常就不跟着 latest 频繁跳，只在该线上拿维护补丁。对新手和”跑起来就行”的生产环境比较友好。

openclaw update --channel extended-stable

Tip

不确定选哪个？个人折腾选 stable，服务器长期挂着选 extended-stable，省心。

升级后要做的事

升级不是敲完命令就完了。按顺序确认一遍：

openclaw update status
openclaw gateway status
openclaw doctor
openclaw channels status --probe

看 gateway status 报的版本是不是预期的。
看 doctor 有没有阻断项。
看渠道探针是否都 works / audit ok。

如果 openclaw update 装好了核心包，但插件同步没跑完，可以补一刀：

openclaw update repair

何时回退（以及为什么谨慎）

多数情况不需要回退。只有这两类才考虑：

新版在你环境上确有 bug，且暂时无解。
你误装了 dev / beta 到生产，想回到稳定线。

回退要用更老的版本，OpenClaw 会要求确认。极端救急时（仅限故意降级或紧急恢复），单条命令临时允许老二进制执行破坏性动作：

OPENCLAW_ALLOW_OLDER_BINARY_DESTRUCTIVE_ACTIONS=1 openclaw gateway install --force

Warning

这个环境变量是”破坏性行为”开关，正常操作绝不设置。另外，如果配置已经被新版迁移过（比如会话迁到了 SQLite），回退前要先恢复旧的归档记录，否则老版本读不了新格式。

更简单也更安全的回退，是直接重装目标版本：

npm install -g openclaw@2026.6.33

装完同样 openclaw gateway restart。

小结

升级就两条路：npm 重装，或 openclaw update。版本号 YYYY.M.PATCH 里补丁号是否过 33，决定了它走 latest 还是 extended-stable。日常用 stable，求稳用 extended-stable，回退留给真出问题时再用，而且别轻易开那个危险环境变量。