开发频道

最后更新：2026-01-21

OpenClaw 提供三个更新频道：

  • stable：npm dist-tag latest。
  • beta：npm dist-tag beta（测试中的构建）。
  • dev：主分支的最新提交（git）。npm dist-tag：dev（发布时）。

我们会向 beta 发送构建版本，测试后，将经过验证的构建提升到 latest 而不会更改版本号 —— dist-tag 是 npm 安装的真实来源。

切换频道

Git checkout：

openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev
  • stable/beta 会检出最新的匹配标签（通常是同一个标签）。
  • dev 会切换到 main 并重新基于上游。

npm/pnpm 全局安装：

openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev

这会通过相应的 npm dist-tag（latest、beta、dev）进行更新。

当你明确使用 --channel 切换频道时，OpenClaw 还会同步安装方式：

  • dev 确保使用 git checkout（默认 ~/openclaw，可使用 OPENCLAW_GIT_DIR 覆盖）， 更新它，并从该 checkout 安装全局 CLI。
  • stable/beta 从 npm 安装，使用匹配的 dist-tag。

提示：如果你想同时运行 stable 和 dev，请保留两个克隆版本，并将你的 gateway 指向 stable 版本。

插件和频道

当你使用 openclaw update 切换频道时，OpenClaw 还会同步插件来源：

  • dev 优先使用 git checkout 中的捆绑插件。
  • stable 和 beta 会恢复通过 npm 安装的插件包。

标记最佳实践

  • 为你希望 git checkout 落地的版本打标签（stable 使用 vYYYY.M.D，beta 使用 vYYYY.M.D-beta.N）。
  • 也支持 vYYYY.M.D.beta.N 兼容性写法，但推荐使用 -beta.N。
  • 旧的 vYYYY.M.D-<patch> 标签仍被识别为 stable（非 beta）。
  • 保持标签不可变：永远不要移动或重用标签。
  • npm dist-tag 仍是 npm 安装的真实来源：
    • latest → stable
    • beta → 候选构建
    • dev → main 快照（可选）

macOS 应用可用性

Beta 和 dev 构建可能不包含 macOS 应用发布。这没问题：

  • git 标签和 npm dist-tag 仍可以发布。
  • 在发布说明或变更日志中说明”此 beta 无 macOS 构建”。