开发通道

Last updated: 2026-01-21

OpenClaw 提供三个更新通道：

• stable：npm dist-tag latest。
• beta：npm dist-tag beta（正在测试的构建）。
• dev：main 的滚动 head（git）。npm dist-tag：dev（当发布到 npm 时）。

我们会先把构建发布到 beta，测试后，再把验证过的构建提升（promote）到 latest， 且不会更改版本号 —— 对 npm 安装来说，dist-tags 才是事实来源（source of truth）。

切换通道

Git checkout：

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

• stable/beta 会 checkout 最新的匹配 tag（往往是同一个 tag）。
• dev 会切到 main 并对 upstream 做 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 会从 npm 使用对应 dist-tag 安装。

提示：如果你想同时保留 stable + dev，建议保留两个 clone，并让 gateway 指向 stable 那份。

Plugins 与通道

当你用 openclaw update 切换通道时，OpenClaw 也会同步 plugin sources：

• dev 更偏向使用 git checkout 中捆绑的 plugins。
• stable 与 beta 会恢复为 npm 安装的 plugin packages。

Tagging 最佳实践

• 对你希望 git checkouts 落到的版本打 tag（vYYYY.M.D 或 vYYYY.M.D-<patch>）。
• 保持 tags 不可变：永远不要移动或复用一个 tag。
• 对 npm 安装来说，npm dist-tags 仍是事实来源：
  • latest → stable
  • beta → 候选构建
  • dev → main 快照（可选）

macOS app 可用性

Beta 与 dev 构建可能不包含 macOS app 的 release。这没问题：

• git tag 与 npm dist-tag 仍可发布。
• 在 release notes 或 changelog 中说明 “本 beta 无 macOS build”。