跳转到内容
OpenClaw Docs

发布渠道

OpenClaw 提供三个更新通道：

  • stable：npm dist-tag latest。推荐大多数用户使用。
  • beta：当其为当前版本时，使用 npm dist-tag beta；如果 beta 缺失或比最新的 stable 版本旧，更新流程将回退到 latest。
  • dev：main (git) 的移动头部。npm dist-tag：dev（发布时）。 main 分支用于实验和活跃开发。它可能包含未完成的功能或破坏性更改。请勿将其用于生产网关。

我们通常先将 stable 构建发布到 beta，在那里进行测试，然后运行显式的提升步骤，将经过审查的构建移动到 latest 而不更改版本号。维护者也可以在需要时直接将 stable 版本发布到 latest。Dist-tags 是 npm 安装的单一事实来源。

切换通道

Section titled “切换通道”
Terminal window
openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev

--channel 会将您的选择保存在配置（update.channel）中并对齐安装方法：

  • stable（包安装）：通过 npm dist-tag latest 更新。
  • beta（包安装）：首选 npm dist-tag beta，但当 beta 缺失或比当前 stable tag 旧时，回退到 latest。
  • stable (git 安装)：检出最新的稳定 git 标签，排除 诸如 -alpha.N、-beta.N、-rc.N、-dev.N、 -next.N、-preview.N、-canary.N、-nightly.N 以及其他预发布 后缀之类的 semver 预发布标签。
  • beta (git 安装)：首选最新的 beta git 标签，但当 beta 缺失或较旧时回退到 最新的稳定 git 标签。
  • dev：确保 git 检出（默认为 ~/openclaw，或在设置了 OPENCLAW_HOME 时为 $OPENCLAW_HOME/openclaw；可通过 OPENCLAW_GIT_DIR 覆盖），切换到 main，在 upstream 上变基，构建，并 从该检出安装全局 CLI。

一次性指定版本或标签

Section titled “一次性指定版本或标签”

使用 --tag 来指定特定的 dist-tag、版本或包规范，以进行单次更新，而不更改您持久化的渠道：

Terminal window
# Install a specific version
openclaw update --tag 2026.4.1-beta.1


# Install from the beta dist-tag (one-off, does not persist)
openclaw update --tag beta


# Switch to the moving GitHub main checkout
openclaw update --channel dev


# Install a specific npm package spec
openclaw update --tag [email protected]


# Install from GitHub main once without persisting the channel
openclaw update --tag main

注意：

  • --tag 仅适用于包 (npm) 安装。Git 安装会忽略它。
  • 该标签不会被持久化。您的下一次 openclaw update 将照常使用您配置的渠道。
  • 对于包安装，OpenClaw 会在分阶段 GitHub 安装之前将 npm/git 源规范预打包到 临时 tarball 中。当您希望将动态的 main 检出作为持久化安装时，请使用 --channel dev 或 --install-method git --version main。
  • 降级保护：如果目标版本低于您当前的版本， OpenClaw 会提示确认（使用 --yes 跳过）。
  • --channel beta 与 --tag beta 不同：渠道流程可以在 beta 缺失或较旧时回退 到 stable/latest，而 --tag beta 针对那一次运行定位 原始的 beta dist-tag。

试运行

Section titled “试运行”

预览 openclaw update 将执行的操作而不进行实际更改：

Terminal window
openclaw update --dry-run
openclaw update --channel beta --dry-run
openclaw update --tag 2026.4.1-beta.1 --dry-run
openclaw update --dry-run --json

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

插件和渠道

Section titled “插件和渠道”

当您使用 openclaw updateOpenClaw 切换频道时，OpenClaw 还会同步插件 源：

  • dev 优先使用 git checkout 中的捆绑插件。
  • stable 和 betanpm 会恢复通过 npm 安装的插件包。
  • 核心更新完成后，npm 安装的插件会被更新。

检查当前状态

Section titled “检查当前状态”
Terminal window
openclaw update status

显示活动渠道、安装类型（git 或 package）、当前版本以及来源（配置、git tag、git 分支或默认值）。

标记最佳实践

Section titled “标记最佳实践”
  • 为您希望 git checkout 指向的版本打上标签（stable 版为 vYYYY.M.D， beta 版为 vYYYY.M.D-beta.N；命名的 semver 预发布后缀，如 -alpha.N、-rc.N 和 -next.N，不是稳定的目标）。
  • 出于兼容性考虑，传统的数字稳定标签（如 vYYYY.M.D-1 和 v1.0.1-1）仍 被视为稳定的 git 标签。
  • 出于兼容性考虑，vYYYY.M.D.beta.N 也被识别，但建议使用 -beta.N。
  • 保持标签不可变：切勿移动或重用标签。
  • npm dist-tags 仍然是 npm 安装的事实来源：
    • latest -> stable
    • beta -> 候选构建或 beta 优先的稳定构建
    • dev -> main 快照（可选）

macOS 应用可用性

Section titled “macOS 应用可用性”

Beta 和 dev 构建可能不包含 macOS 应用版本。这是正常的：

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

相关

Section titled “相关”