开发频道

最近更新：2026-01-21

OpenClaw 提供三个更新频道：

• stable：npm dist-tag 为 latest。
• beta：npm dist-tag 为 beta（测试中的构建版本）。
• dev：main 分支的最新提交（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 会 checkout 最新匹配的标签（通常是同一个标签）。
• dev 会切换到 main 分支并对上游进行 rebase。

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 使用对应 dist-tag 从 npm 安装。

小技巧：如果想同时使用 stable 和 dev，保留两份克隆，让网关指向 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 构建”即可。