发布渠道

OpenClaw 提供三个更新渠道：

• stable：npm dist-tag latest，大多数用户推荐使用。
• beta：npm dist-tag beta（测试中的构建版本）。
• dev：main 分支的滚动最新版（git）。npm dist-tag：dev（发布时）。 main 分支用于实验和活跃开发，可能包含不完整功能或破坏性变更，不要用于生产 Gateway。

我们先将构建发布到 beta，测试通过后将验证的构建提升为 latest，不更改版本号——dist-tag 是 npm 安装的权威来源。

切换渠道

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

--channel 会将你的选择持久化到配置中（update.channel），并对齐安装方式：

• stable/beta（npm 包安装）：通过匹配的 npm dist-tag 更新。
• stable/beta（git 安装）：切换到最新的匹配 git tag。
• dev：确保 git checkout（默认 ~/openclaw，可通过 OPENCLAW_GIT_DIR 覆盖），切换到 main，变基到上游，构建，并从该 checkout 安装全局 CLI。

提示：如果你想同时运行 stable + dev，保留两个克隆，将 Gateway 指向 stable 那个。

一次性版本或标签定向

使用 --tag 指定一个特定的 dist-tag、版本或 package spec 进行单次更新，不会更改持久化的渠道：

# 安装特定版本
openclaw update --tag 2026.3.26

# 安装 beta dist-tag（一次性，不持久化）
openclaw update --tag beta

# 从 GitHub main 分支安装（npm tarball）
openclaw update --tag main

# 安装特定 npm package spec
openclaw update --tag openclaw@2026.3.26

注意：

• --tag 仅适用于 npm 包安装，git 安装会忽略它。
• 标签不会持久化，下次 openclaw update 仍使用配置的渠道。
• 降级保护：如果目标版本比当前版本旧，OpenClaw 会提示确认（加 --yes 跳过）。

干运行

预览 openclaw update 会做什么，不实际执行变更：

openclaw update --dry-run
openclaw update --channel beta --dry-run
openclaw update --tag 2026.3.26 --dry-run
openclaw update --dry-run --json

干运行会显示有效渠道、目标版本、计划操作，以及是否需要降级确认。

插件和渠道同步

使用 openclaw update 切换渠道时，OpenClaw 也会同步插件来源：

• dev 优先使用 git checkout 中的内置插件。
• stable 和 beta 恢复 npm 安装的插件包。
• npm 安装的插件在核心更新完成后更新。

查看当前状态

openclaw update status

显示当前活跃渠道、安装类型（git 或 npm 包）、当前版本和来源（配置、git tag、git 分支或默认值）。

打标签最佳实践

• 为希望 git checkout 落地的版本打标签（stable 用 vYYYY.M.D，beta 用 vYYYY.M.D-beta.N）。
• vYYYY.M.D.beta.N 也被识别，兼容处理，但优先使用 -beta.N。
• 遗留的 vYYYY.M.D-<patch> tag 仍被识别为 stable（非 beta）。
• 保持 tag 不可变：不要移动或复用已有的 tag。
• npm dist-tag 仍是 npm 安装的权威来源：
  • latest → stable
  • beta → 候选构建
  • dev → main 快照（可选）

macOS App 可用性

Beta 和 dev 构建可能不包含 macOS App 发布。这是正常的：

• git tag 和 npm dist-tag 仍可发布。
• 在发布说明或 changelog 中注明"此 beta 无 macOS 构建"即可。