跳轉到主要內容

​
openclaw update

安全地更新 OpenClaw，並在 stable / beta / dev 頻道之間切換。 如果你是透過 npm/pnpm 安裝（全域安裝，沒有 git 中繼資料），更新會依照套件管理器流程進行，請參閱 Updating。

​
使用方式

openclaw update
openclaw update status
openclaw update wizard
openclaw update --channel beta
openclaw update --channel dev
openclaw update --tag beta
openclaw update --no-restart
openclaw update --json
openclaw --update

​
選項

  • --no-restart：成功更新後略過重新啟動 Gateway 服務。
  • --channel <stable|beta|dev>：設定更新頻道（git + npm；會儲存在設定中）。
  • --tag <dist-tag|version>：僅針對本次更新覆寫 npm dist-tag 或版本。
  • --json：輸出可供機器讀取的 UpdateRunResult JSON。
  • --timeout <seconds>：每個步驟的逾時時間（預設為 1200 秒）。
注意：降版需要確認，因為較舊的版本可能會破壞設定。

​
update status

顯示目前啟用的更新頻道，以及 git 標籤 / 分支 / SHA（適用於來源檢出），並顯示是否有可用更新。 
openclaw update status
openclaw update status --json
openclaw update status --timeout 10
Options：
  • --json：輸出可供機器讀取的狀態 JSON。
  • --timeout <seconds>：檢查的逾時時間（預設為 3 秒）。

​
update wizard

互動式流程，用於選擇更新通道並確認更新後是否重新啟動 Gateway（預設為重新啟動）。 37. 若你選擇 dev 但沒有 git 檢出， 它會提供建立一個。

​
What it does

當你明確切換頻道（--channel ...）時，OpenClaw 也會維持 安裝方式的一致性：
  • dev → 確保存在 git 檢出（預設：~/openclaw，可用 OPENCLAW_GIT_DIR 覆寫）， 更新後，並從該檢出安裝全域 CLI。
  • stable/beta → 使用對應的 dist-tag 從 npm 安裝。

​
Git checkout flow

頻道：
  • stable：檢出最新的非 beta 標籤，然後建置 + doctor。
  • beta：檢出最新的 -beta 標籤，然後建置 + doctor。
  • dev：檢出 main，然後 fetch + rebase。
高階流程：
  1. 需要乾淨的工作樹（沒有未提交的變更）。
  2. 切換到所選的頻道（標籤或分支）。
    1. 取得上游更新（僅 dev）。
  4. 僅 dev：在暫存工作樹中進行 lint 與 TypeScript 建置的預檢；如果目前提交失敗，會往回最多 10 個提交，找出最新可成功建置的版本。
  5. 重新基底到所選提交（僅 dev）。
  6. 安裝相依套件（優先使用 pnpm；後備為 npm）。
  7. 建置，並建置 Control UI。
  8. 執行 openclaw doctor，作為最終的「安全更新」檢查。
  9. 將外掛同步至目前啟用的頻道（dev 使用隨附的擴充；stable / beta 使用 npm），並更新以 npm 安裝的外掛。

​
--update shorthand

openclaw --update 會重寫為 openclaw update（對於 shell 與啟動器腳本很實用）。

​
See also