OC
OpenClaw 中文解释版

给五岁小朋友也能看懂的说明书

简要总结

Development Channels

这页说明书在讲 OpenClaw 的“更新频道”。你可以把它想成是看电视,有三个不同的台:一个最稳定的台,一个在测试的新节目台,还有一个每天都在变的最新节目台。这页会告诉你怎么在这三个台之间切换,让你能选择用最稳的版本,还是试试最新的功能。当你需要换一个版本用的时候,就可以来看看这页。

五岁小孩版解释

OpenClaw 有三个不同的更新频道,就像三个不同的电视台。

  1. stable(稳定版):这是最稳当、最可靠的频道。它对应 npm 上的 latest 标签。
  2. beta(测试版):这个频道里的版本正在被测试,就像节目播出前要先试播一下。它对应 npm 上的 beta 标签。
  3. dev(开发版):这是最新的频道,每天都在变化,就像节目还在排练和修改。它对应着代码仓库里最新的 main 分支,以及 npm 上的 dev 标签。

通常,一个版本会先在 beta 频道测试,没问题了,再“升级”到 stable 频道,让大家都能用。

怎么切换频道呢?

这取决于你最开始是怎么安装 OpenClaw 的。

  • 如果你是用 Git 方式安装的(就是从代码仓库直接下载的),你可以用下面的命令来换台: openclaw update --channel stable openclaw update --channel beta openclaw update --channel dev

    • stablebeta,它会帮你找到这个频道里最新的那个版本。
    • dev,它会切换到最新的 main 分支代码。
  • 如果你是用 npm 或 pnpm 全局安装的(就像从应用商店安装软件),也是用上面一样的命令来换台: openclaw update --channel stable openclaw update --channel beta openclaw update --channel dev

    • 这个命令会通过对应的 npm 标签(latest, beta, dev)来更新你的软件。

换台时会发生什么?

当你用 --channel 命令明确说要换台时,OpenClaw 还会聪明地调整你的安装方式。

  • 如果你换到 dev 频道,它会确保你有一个 Git 代码仓库(默认在 ~/openclaw 目录),更新它,然后从这个仓库安装软件。
  • 如果你换到 stablebeta 频道,它会从 npm 上用对应的标签来安装。

换台时,插件怎么办?

别担心,当你用 openclaw update 换台时,OpenClaw 也会帮你同步插件。

  • dev 频道,它更喜欢用 Git 仓库里自带的插件。
  • stablebeta 频道,它会恢复成从 npm 安装的插件包。

需要小心的事情

  • 给版本贴标签:如果你想让大家通过 Git 安装到某个版本,记得给它打上标签。稳定版用 vYYYY.M.D(比如 v2026.1.21),测试版用 vYYYY.M.D-beta.N(比如 v2026.1.21-beta.1)。
  • 标签不能乱动:一个标签贴好了,就不要再移动它或者重复用了。
  • Mac 电脑要注意:在 betadev 频道,可能没有专门给 macOS 系统做的 App 安装包。这是正常的,软件的其他部分还是可以用的。发布说明里会写清楚“这个测试版没有 Mac 安装包”。