Files
Moltbot/docs/zh-CN/install/development-channels.md
Josh Palmer 5676a6b38d Docs: normalize zh-CN terminology + tone
What: switch to 你/你的 tone; standardize Skills/Gateway网关/local loopback/私信 wording
Why: align zh-CN docs with issue 6995 feedback + idiomatic tech style
Tests: pnpm docs:build
2026-02-02 16:38:25 +01:00

2.6 KiB
Raw Blame History

read_when, summary, title, x-i18n
read_when summary title x-i18n
你想在稳定版/测试版/开发版之间切换
你正在标记或发布预发布版本
稳定版、测试版和开发版渠道:语义、切换和标签管理 开发渠道
generated_at model provider source_hash source_path workflow
2026-02-01T21:05:54Z claude-opus-4-5 pi 2b01219b7e705044ce39838a0da7c7fa65c719809ab2f8a51e14529064af81bf install/development-channels.md 14

开发渠道

最后更新2026-01-21

OpenClaw 提供三个更新渠道:

  • stablenpm dist-tag latest
  • betanpm dist-tag beta(测试中的构建)。
  • devmain 分支的最新提交git。npm dist-tagdev(发布时)。

我们将构建发布到 beta,进行测试,然后将经过验证的构建提升为 latest,无需更改版本号 — dist-tag 是 npm 安装的权威来源。

切换渠道

Git checkout 方式:

openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev
  • stable/beta 会签出最新匹配的标签(通常是同一个标签)。
  • dev 切换到 main 并在上游基础上进行 rebase。

npm/pnpm 全局安装方式:

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

这会通过对应的 npm dist-taglatestbetadev)进行更新。

当你显式使用 --channel 切换渠道时OpenClaw 也会同步调整安装方式:

  • dev 确保存在 git checkout默认 ~/openclaw,可通过 OPENCLAW_GIT_DIR 覆盖),更新它,并从该 checkout 安装全局 CLI。
  • stable/beta 使用匹配的 dist-tag 从 npm 安装。

提示:如果你想同时使用 stable 和 dev可以保留两个克隆并将 Gateway网关指向 stable 的那个。

插件与渠道

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

  • dev 优先使用 git checkout 中内置的插件。
  • stablebeta 恢复通过 npm 安装的插件包。

标签最佳实践

  • 为你希望 git checkout 落到的版本打标签(vYYYY.M.DvYYYY.M.D-<patch>)。
  • 保持标签不可变:永远不要移动或重用标签。
  • npm dist-tag 仍然是 npm 安装的权威来源:
    • latest → 稳定版
    • beta → 候选构建
    • dev → main 快照(可选)

macOS 应用可用性

测试版和开发版构建可能不包含 macOS 应用发布。这是正常的:

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