Skip to main content

​
开发渠道

最后更新：2026-01-21 OpenClaw 提供三个更新渠道：
  • 稳定版：npm dist-tag latest。
  • 测试版：npm dist-tag beta（正在测试的构建）。
  • 开发版：指向 main 的最新提交（Git）。npm dist-tag：dev（发布时）。
我们先将构建推送到 beta 渠道，进行测试，然后将经过验证的构建 提升到 latest， 而无需更改版本号——npm 安装以 dist-tag 为准。

​
切换渠道

Git 检出： 
openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev
  • stable/beta 检出最新的匹配标签（通常为同一标签）。
  • dev 切换到 main 并基于上游重新基底。
npm/pnpm 全局安装： 
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 应用可用性

Beta 和 dev 构建可能 不 包含 macOS 应用版本。这是正常的：
  • Git 标签和 npm dist-tag 仍然可以发布。
  • 在发布说明或变更日志中注明“此 beta 版无 macOS 构建”。