openclaw backup

為 OpenClaw 的狀態、設定、憑證、工作階段，以及選擇性的工作區建立本地備份封存檔。

openclaw backup create
openclaw backup create --output ~/Backups
openclaw backup create --dry-run --json
openclaw backup create --verify
openclaw backup create --no-include-workspace
openclaw backup create --only-config
openclaw backup verify ./2026-03-09T00-00-00.000Z-openclaw-backup.tar.gz

注意事項

  • 封存檔內含一個 manifest.json，記錄已解析的來源路徑和封存檔佈局。
  • 預設輸出為帶有時間戳記的 .tar.gz 封存檔，存放在目前工作目錄。
  • 如果目前工作目錄位於要備份的來源目錄樹內，OpenClaw 會改用家目錄作為預設封存檔位置。
  • 不會覆寫既有的封存檔。
  • 位於來源狀態/工作區目錄樹內的輸出路徑會被拒絕，以避免自我包含。
  • openclaw backup verify <archive> 會驗證封存檔只含一個根層級 manifest，拒絕含有目錄穿越風格的路徑，並檢查 manifest 中宣告的每個載荷是否都存在於 tarball 中。
  • openclaw backup create --verify 會在寫入封存檔後立即執行驗證。
  • openclaw backup create --only-config 只備份當前使用的 JSON 設定檔。

備份的內容

openclaw backup create 會從你的本地 OpenClaw 安裝規劃備份來源：

  • OpenClaw 本地狀態解析器回傳的狀態目錄，通常是 ~/.openclaw
  • 當前使用的設定檔路徑
  • OAuth / 憑證目錄
  • 從目前設定中探索到的工作區目錄（除非你傳入 --no-include-workspace）

使用 --only-config 時，OpenClaw 會跳過狀態、憑證和工作區探索，只封存當前使用的設定檔路徑。

OpenClaw 在建立封存檔前會正規化路徑。如果設定、憑證或工作區已位於狀態目錄內，不會作為獨立的頂層備份來源重複封存。缺少的路徑會被跳過。

封存載荷儲存這些來源目錄樹的檔案內容，嵌入的 manifest.json 記錄已解析的絕對來源路徑，以及每個資產使用的封存佈局。

無效設定的行為

openclaw backup 刻意繞過正常的設定前置檢查，以便在復原情境下仍然能夠協助。由於工作區探索依賴有效的設定，當設定檔存在但無效且工作區備份仍啟用時，openclaw backup create 會立即失敗。

若在此情況下仍需部分備份，請重新執行：

openclaw backup create --no-include-workspace

這會保留狀態、設定和憑證，同時完全跳過工作區探索。

如果你只需要設定檔本身的副本，--only-config 在設定檔格式有誤時同樣可用，因為它不依賴設定解析來探索工作區。

大小與效能

OpenClaw 沒有內建的最大備份大小或單檔大小限制。

實際限制取決於本地機器和目標檔案系統：

  • 臨時封存寫入加上最終封存所需的可用空間
  • 走訪大型工作區目錄樹並壓縮為 .tar.gz 所需的時間
  • 使用 openclaw backup create --verify 或執行 openclaw backup verify 時重新掃描封存檔的時間
  • 目標路徑的檔案系統行為。OpenClaw 優先使用不覆寫的硬連結發布步驟，不支援硬連結時則改用排他式複製

大型工作區通常是封存大小的主要因素。如果你需要較小或較快的備份，請使用 --no-include-workspace。

要取得最小的封存檔，請使用 --only-config。

下一頁
Overview
arrow_forward