開發頻道

最後更新：2026-01-21

OpenClaw 提供三個更新頻道：

• stable：npm dist-tag latest。
• beta：npm dist-tag beta（測試中的建置）。
• dev：main 的最新 HEAD（git）。npm dist-tag：dev（發布時）。

我們將建置發布到 beta，測試後，再將經過驗證的建置提升到 latest， 不改變版本號——dist-tag 是 npm 安裝的唯一真實來源。

切換頻道

Git checkout：

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

• stable/beta 切換到最新匹配的標籤（通常是同一個標籤）。
• dev 切換到 main 並 rebase 到 upstream。

npm/pnpm 全域安裝：

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

透過對應的 npm dist-tag（latest、beta、dev）更新。

當你明確使用 --channel 切換頻道時，OpenClaw 也會同步安裝方式：

• dev 確保有 git checkout（預設 ~/openclaw，可用 OPENCLAW_GIT_DIR 覆寫），更新並從該 checkout 安裝全域 CLI。
• stable/beta 從 npm 使用對應 dist-tag 安裝。

小技巧：如果想同時使用 stable + dev，維護兩個 clone 並將閘道指向 stable 的那個。

外掛與頻道

使用 openclaw update 切換頻道時，OpenClaw 也會同步外掛來源：

• dev 偏好 git checkout 中內建的外掛。
• stable 和 beta 恢復 npm 安裝的外掛套件。

標籤最佳實務

• 為你希望 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-tag 仍是 npm 安裝的真實來源：
  • latest → stable
  • beta → 候選建置
  • dev → main 快照（選用）

macOS 應用程式可用性

Beta 和 dev 建置可能不包含 macOS 應用程式發布。這很正常：

• Git 標籤和 npm dist-tag 仍然可以發布。
• 在 release notes 或 changelog 中註明「此 beta 無 macOS 建置」。