Development Channels

最后更新：2026-01-21

OpenClaw 提供三个更新 channel：

• stable：npm dist-tag latest。
• beta：npm dist-tag beta（测试中的构建版本）。
• dev：main 分支的最新代码（git）。npm dist-tag：dev（发布时）。

我们会先将构建版本发布到 beta 进行测试，然后将经过验证的构建版本提升到 latest，版本号不变——dist-tag 是 npm 安装的真实来源。

切换 channel

Git checkout 方式：

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

• stable/beta 会检出最新的匹配标签（通常是同一个标签）。
• dev 会切换到 main 分支并在上游进行 rebase。

npm/pnpm 全局安装方式：

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

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

当你明确使用 --channel 切换 channel 时，OpenClaw 也会调整安装方式：

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

提示：如果你想同时使用 stable 和 dev，可以保留两个克隆仓库，并将 Gateway 指向 stable 版本。

Plugin 和 channel

当你使用 openclaw update 切换 channel 时，OpenClaw 也会同步 plugin 来源：

• dev 优先使用 git checkout 中的捆绑 plugin。
• stable 和 beta 会恢复从 npm 安装的 plugin 包。

标签管理最佳实践

• 为你希望 git checkout 落地的版本打标签（vYYYY.M.D 或 vYYYY.M.D-<patch>）。
• 保持标签不可变：永远不要移动或重用标签。
• npm dist-tag 始终是 npm 安装的真实来源：
  • latest → stable
  • beta → 候选构建版本
  • dev → main 快照（可选）

macOS 应用可用性

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

• git 标签和 npm dist-tag 仍然可以发布。
• 在发布说明或更新日志中注明”此 beta 版本没有 macOS 构建”。