
版本 · 渠道
OpenClaw 四个更新渠道现在各是哪一版,该装哪个、怎么切
直接装稳定版。OpenClaw 的更新渠道文档一共列了四个更新渠道(update channel,也译作更新通道),stable 对应 npm 的 latest 标签,后面跟的说明是「推荐给大多数用户」。截至 2026 年 10 月 7 日,这个标签指向 2026.9.8。还没装的,安装步骤见《本地部署 OpenClaw 龙虾:Win/Mac/Linux 三平台教程》。
另外三个各有对象。Gateway 上跑着不方便中断的任务、宁可晚些拿到新功能的,看 extended-stable,本文叫它长期支持版:每月出一条线,之后往里回补安全和可靠性修复,安装和升级都要自己动手。官方博客的说法是它让 OpenClaw 离正式的 LTS 版本更近一步,并没有把它叫作正式的 LTS;一条线支持到下一条发布为止,最少一个月。想提前试下一版的才切 beta。dev 跟着 Git 上 main 分支的最新提交走,文档写的是可能带着没做完的功能或破坏性改动,不要拿它跑生产环境的 Gateway。
stable、extended-stable、beta 该装哪个,现在各指向哪个版本号
下表的版本号是 2026 年 10 月 7 日在 npm 的 dist-tags 接口上查到的。用 npm 安装时认的就是这组标签,打开那个地址看到的是当下的值。命令行里查同一组值用 npm view openclaw dist-tags。
| 渠道 | npm 标签 | 现在的版本 | 适合谁 |
|---|---|---|---|
| stable(稳定版) | latest | 2026.9.8 | 第一次装的、日常使用的 |
| extended-stable(长期支持版) | extended-stable | 2026.8.35 | 用 npm 包安装、希望版本少变动的 Gateway |
| beta(测试版) | beta | 2026.10.1-beta.1 | 想提前试下一版、出了问题能自己退回的 |
| dev | 不走 npm 标签,跟 Git 的 main 分支 | main 的最新提交 | 做实验、参与开发的;不用于生产环境 |
GitHub 发布页上这三个版本的日期(UTC)分别是:2026.9.8 为 10 月 3 日,标着 Latest;2026.10.1-beta.1 为 10 月 5 日,标着 Pre-release;2026.8.35 为 10 月 2 日。2026.9.8 改了什么、从 9.7 升上来失败怎么处理,见《OpenClaw 2026.9.8 更新内容与升级失败的处理办法》。
稳定版、测试版、长期支持版和 dev 的区别在哪
按渠道文档的说法,稳定版通常先发到 beta,在那里验过以后提升为 latest,版本号不变;维护者也可以直接发到 latest。beta 标签上放的也可能是带 -beta.N 后缀的候选版本,上表里带 -beta 后缀的那个就是这种。
beta 渠道取的是 npm 上 beta 和 latest 两个标签里、按语义化版本排序更新的那个,旧的 beta 标签不会顶掉更新的稳定版。按上表的版本号,2026.10.1-beta.1 比 2026.9.8 新,现在切到 beta 装到的是这个测试版。用 macOS 应用的多留意一条:beta 和 dev 的构建可能不带 macOS 应用的发布。
extended-stable 是 2026 年 7 月 30 日官方博客宣布的渠道。博客给的节奏是每月发布一条线,一条线支持到下一条发布为止,最少一个月,期间从后面的版本回补安全和可靠性修复。编号也有规则:每条线从 YYYY.M.33 开始,每回补一次,补丁号加一。2026.8.35 是 8 月那条线上的第三个编号:GitHub 发布页上 2026.8.33 的日期是 9 月 29 日,2026.8.34 和 2026.8.35 都是 10 月 2 日(UTC)。三个版本的发布说明开头是同一段话:这是一个 gateway-only 的 extended-stable 版本,是官方「目前相当于 LTS」的东西,内容是 2026 年 8 月底的 OpenClaw,加上关键安全更新、可靠性和性能修复,以及新模型支持这类功能。
dev 渠道装的不是 npm 上的包。切到 dev,OpenClaw 会切换到一份 Git checkout,构建,再重新安装全局 CLI;本来就是 git 安装的,则是拉取上游、把 checkout 变基到 main 分支,然后构建、重装。
怎么看自己装的 OpenClaw 是哪一版、在哪个渠道
在装着 OpenClaw 的机器上执行:
openclaw update status
输出里有四项和选版本有关:
- 当前渠道,以及这个渠道是由什么定下来的,取值是 config、git tag、git branch、installed version、default 之一。
- 安装方式,git 或 package。
- 当前版本。
- 有没有可用更新。
同一条命令还会列出上一次记录下来的更新运行。不带 update 的 openclaw status 不一样,它用的是缓存、不重新抓取;最近一次记录的更新抓取失败时,它显示 update check stale: last update fetch failed,后面带着失败距今多久和简短原因。看到这一行,执行 openclaw update status 做一次新的检查,或者再执行一次 openclaw update。要给脚本用,更新命令文档给的写法是 openclaw update status --json。
安装方式这一项决定了后面能走哪条路:显示 git 的切不到 extended-stable,原因见下文「长期支持版 extended-stable 适合谁,有哪些限制」。
切换渠道用哪条命令,只想临时装一次别的版本呢
四个渠道各一条:
openclaw update --channel stable
openclaw update --channel extended-stable
openclaw update --channel beta
openclaw update --channel dev
--channel 做两件事:按新渠道执行一次更新,并在核心更新成功之后把选择写进配置里的 update.channel。更新被拒绝或者失败的,保留原来的渠道。
真正动手之前可以在命令后面加 --dry-run,例如:
openclaw update --channel beta --dry-run
预演会报出生效的渠道、目标版本、计划执行的动作,以及这次是否需要降级确认。它不写配置、不安装、不同步插件,也不重启。目标版本和 dist-tags 接口当下显示的值对不上的,停下来查清楚再执行。
不想背参数的,openclaw update wizard 是一个交互式流程,让你选渠道,并确认更新完要不要重启 Gateway,默认重启。
只想装一次某个版本、不改渠道,用 --tag:
openclaw update --tag beta
openclaw update --tag 2026.10.1-beta.1
第二条里的版本号换成你要装的那一个。--tag 后面可以跟 dist-tag、版本号或包规格。它只管这一次更新,标签不会保存,下一次执行 openclaw update 仍然按配置里的渠道走。它只对 npm 包安装生效,git 安装会忽略它。
切渠道的时候插件来源会跟着同步。切到 dev,已安装的插件里有内置对应版本的,会换回内置的那份;切到 stable 或 beta,恢复成从 npm 或 ClawHub 安装的插件包。npm 安装的插件在核心更新完成之后才更新。
切换失败,或者想从 beta、dev 退回稳定版怎么办
退回用的还是那条命令:
openclaw update --channel stable
dev 那种 git 安装执行它,会换成 npm 上 latest 对应的包。
从 beta 退回,装着的版本比 latest 新的时候要多过一道确认。渠道文档里有一条降级保护:目标版本比当前版本旧,OpenClaw 会要求确认,带 --yes 可以跳过。按上表的版本号,从 2026.10.1-beta.1 回到 2026.9.8 正好属于这种情况;从 2026.9.8 换到 extended-stable 的 2026.8.35 也一样。
要确认的理由,更新命令文档写的是旧版本可能破坏配置,并举了一种情况:安装已经把会话迁移到 SQLite 的,在启动一个较旧的、基于文件存储的版本之前,要先恢复归档起来的旧会话记录文件。所以我建议切 beta 或 dev 之前做一份备份,退回的时候手里有东西可用。备份和回退的做法在《OpenClaw 升级、回滚与彻底卸载》。
切换本身失败的,渠道没有变,配置里还是原来那个。执行 openclaw update status 看上一次更新记录了什么,再对照《OpenClaw 更新失败按 doctor-failed 等报错逐个处理》里对应的报错处理。
长期支持版 extended-stable 适合谁,有哪些限制
它适合宁可晚些拿到新功能、也要版本少变动的安装。博客交代的背景是,OpenClaw 正在变成个人和财富 500 强公司用来跑越来越关键的工作的基础设施,这个渠道是因此推出的。装它就要接受版本落后:现在的 2026.8.35 是 8 月那条线,稳定版已经到 2026.9.8。
装之前把下面几条对一遍,都是渠道文档和更新命令文档里的限制:
- 只支持包安装。git 安装执行
openclaw update --channel extended-stable,OpenClaw 不会动那份 checkout,只提示你改用包安装。 - 不会自动更新。安装只能在前台进行;
update.checkOnStart开着的时候它会收到更新提示,但提示是只读的,新版本不会自动装上,出了回补版本要自己执行openclaw update。 - 不回落到别的渠道。更新时 OpenClaw 解析 npm 上公开的
extended-stable标签,校验选中的那个包,装的就是那个确切的版本;这一步不成功就停下,不会改装latest、beta或 dev。 - 不能和
--tag合用。渠道是 extended-stable 时,目标版本必须是校验过的那一个,--tag会被拒绝。openclaw update --tag extended-stable也不是它的一次性写法,渠道文档专门写了这一点。 - 官方插件跟着核心走。符合条件的官方 npm 插件会解析到和已装核心完全相同的版本。
安装命令有两条,作用不同。博客给的第一条是:
npm install -g openclaw@extended-stable
它会装上当前选中的版本,但不会把更新渠道保存下来。要让新装的或已有的包安装以后都跟着这个渠道,执行第二条:
openclaw update --channel extended-stable
已经装着稳定版的,这两条都等于把 2026.9.8 降到 2026.8.35。跳过第一条,只执行第二条:它走的是 OpenClaw 自己的更新流程,会遇到上一节说的降级确认。动手前先加 --dry-run 看更新器给出的结果,再对照《OpenClaw 2026.9.7 更新内容、升级后要改的设置和两个已知故障》里讲数据库和备份的部分核对手里的备份,不要用 --yes 跳过确认。
常见问题
- 2026.8.35 是 10 月才发布的,版本号为什么还停在 8 月?
- 它是 extended-stable 渠道 8 月那条线的回补版本。官方博客写的编号规则是:每个月的 extended-stable 线从 YYYY.M.33 开始,每回补一次安全或可靠性修复,补丁号加一。GitHub 发布页上 2026.8.35 的日期是 2026 年 10 月 2 日(UTC),发布说明称它的内容是 2026 年 8 月底的 OpenClaw,加上关键安全更新、可靠性和性能修复,以及新模型支持这类功能。
- 切到 beta 渠道以后,装上的为什么可能是稳定版?
- beta 渠道取的是 npm 上 beta 和 latest 两个标签里按语义化版本排序更新的那个。beta 标签缺失,或者比 latest 旧的时候,渠道会回落到 latest,装上的就是稳定版。
- 用 Git 源码安装的 OpenClaw 能切到 extended-stable 吗?
- 不能。渠道文档把 git 安装列为 extended-stable 不支持的情况:OpenClaw 会保持那份 checkout 不变,并提示改用包安装。想用这个渠道,先把 git 安装换成包安装:渠道文档写明,执行 openclaw update --channel stable 会把 git 安装换成 npm 上 latest 对应的包。换完再执行 openclaw update --channel extended-stable;extended-stable 的版本落后于 latest,这一步是降级,会遇到降级确认,先加 --dry-run 看结果,不要用 --yes 跳过。
- openclaw update --channel beta 和 openclaw update --tag beta 有什么不同?
- --channel beta 会把渠道保存到配置里,以后的更新都按 beta 渠道走,而且 beta 标签缺失或比 latest 旧时会回落到 latest。--tag beta 只管这一次更新,固定取 npm 上 beta 这个标签对应的版本,不改已保存的渠道,下一次执行 openclaw update 仍按原渠道走。--tag 只对 npm 包安装生效。