ClawCN - OpenClaw 中文版

主题

开发渠道 ​

最后更新：2026-01-21

OpenClaw 提供三个更新渠道：

  • stable：npm dist-tag latest。
  • beta：npm dist-tag beta（测试中的构建）。
  • dev：main（git）的移动头部。npm dist-tag：dev（发布时）。

我们将构建发布到 beta，测试它们，然后将经过审查的构建提升到 latest， 无需更改版本号——dist-tag 是 npm 安装的真实来源。

切换渠道 ​

Git 检出：

bash
openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev
  • stable/beta 检出最新的匹配标签（通常是相同的标签）。
  • dev 切换到 main 并在上游上进行变基。

npm/pnpm 全局安装：

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

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

当您使用 --channel 显式切换渠道时，OpenClaw 还会对齐 安装方法：

  • dev 确保 git 检出（默认 ~/openclaw，使用 OPENCLAW_GIT_DIR 覆盖）， 更新它，并从该检出安装全局 CLI。
  • stable/beta 使用匹配的 dist-tag 从 npm 安装。

提示：如果您想同时使用稳定版和开发版，请保留两个克隆并将您的网关指向稳定版。

插件和渠道 ​

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

  • dev 优先使用来自 git 检出的捆绑插件。
  • stable 和 beta 恢复 npm 安装的插件包。

标签管理最佳实践 ​

  • 标记您希望 git 检出落在的发布版本（vYYYY.M.D 或 vYYYY.M.D-<patch>）。
  • 保持标签不可变：永远不要移动或重用标签。
  • npm dist-tag 仍然是 npm 安装的真实来源：
    • latest → 稳定版
    • beta → 候选构建
    • dev → 主分支快照（可选）

macOS 应用可用性 ​

测试版和开发版构建可能不包含 macOS 应用发布。这没关系：

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