English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

高级

发布渠道

OpenClaw 发布三个更新渠道：

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

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

切换渠道

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 标签时回退到 latest。
  • stable（git 安装）：检出最新的 stable git 标签。
  • beta（git 安装）：优先使用最新的 beta git 标签，但当 beta 缺失或更旧时回退到 最新的 stable git 标签。
  • dev：确保存在一个 git 检出（默认 ~/openclaw，可用 OPENCLAW_GIT_DIR 覆盖），切换到 main，基于上游变基，构建，并 从该检出安装全局 CLI。

一次性指定版本或标签

使用 --tag 为单次更新指定特定 dist-tag、版本或包规范， 不会更改你持久化的渠道：

# 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

# Install from GitHub main branch (npm tarball)
openclaw update --tag main

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

注意：

  • --tag 仅适用于包（npm）安装。git 安装会忽略它。
  • 标签不会持久化。下一次 openclaw update 会照常使用你配置的 渠道。
  • 降级保护：如果目标版本早于当前版本， OpenClaw 会提示确认（可用 --yes 跳过）。
  • --channel beta 不同于 --tag beta：渠道流程可以在 beta 缺失或更旧时 回退到 stable/latest，而 --tag beta 会在该次运行中直接指定 原始 beta dist-tag。

试运行

预览 openclaw update 会执行什么操作，而不进行更改：

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

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

插件和渠道

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

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

检查当前状态

openclaw update status

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

打标签最佳实践

  • 为希望 git 检出落到的版本打标签（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 -> 候选构建或 beta 优先的 stable 构建
    • dev -> main 快照（可选）

macOS 应用可用性

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

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

相关内容