發布通道

OpenClaw 提供三個更新通道：

• stable：npm dist-tag latest。建議大多數使用者使用。
• beta：npm dist-tag beta，若目前存在且為最新；如果 beta 缺少或比 最新穩定版本更舊，更新流程會退回使用 latest。
• dev：main 的移動最新狀態（git）。npm dist-tag：dev（發布時）。 main 分支用於實驗與積極開發。它可能包含 未完成的功能或破壞性變更。請勿將其用於生產環境 gateways。

我們通常會先將穩定建置發布到 beta，在該通道測試後，再執行 明確的提升步驟，將已驗證的建置移至 latest，且不 變更版本號。維護者也可以在需要時將穩定版本 直接發布到 latest。Dist-tags 是 npm 安裝的事實來源。

# 切換通道

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

--channel 會將你的選擇保存在 config（update.channel）中，並對齊 安裝方式：

• stable（套件安裝）：透過 npm dist-tag latest 更新。
• beta（套件安裝）：優先使用 npm dist-tag beta，但當 beta 缺少或比 目前穩定標籤更舊時，會退回使用 latest。
• stable（git 安裝）：checkout 最新的穩定 git 標籤。
• beta（git 安裝）：優先使用最新的 beta git 標籤，但當 beta 缺少或更舊時，會退回使用 最新的穩定 git 標籤。
• dev：確保有 git checkout（預設 ~/openclaw，可用 OPENCLAW_GIT_DIR 覆寫）、切換到 main、在 upstream 上 rebase、建置，並從該 checkout 安裝全域 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。

# Dry run

預覽 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

Dry run 會顯示有效通道、目標版本、計畫動作，以及 是否需要降級確認。

# Plugins 與通道

當你使用 openclaw update 切換通道時，OpenClaw 也會同步 Plugin 來源：

• dev 優先使用 git checkout 中的 bundled plugins。
• stable 與 beta 會還原 npm 安裝的 Plugin 套件。
• npm 安裝的 plugins 會在核心更新完成後更新。

# 檢查目前狀態

openclaw update status

顯示作用中的通道、安裝種類（git 或套件）、目前版本，以及 來源（config、git tag、git branch 或 default）。

# 標記最佳實務

• 為你希望 git checkout 落到的版本加上標籤（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-tags 仍是 npm 安裝的事實來源：
  • latest -> stable
  • beta -> candidate build 或 beta-first stable build
  • dev -> main snapshot（可選）

# macOS app 可用性

Beta 與 dev 建置可能不包含 macOS app 發布。這沒問題：

• git tag 與 npm dist-tag 仍然可以發布。
• 在 release notes 或 changelog 中註明「此 beta 沒有 macOS build」。

# 相關

• 更新
• 安裝程式內部機制