backup

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> 會驗證封存僅包含一個根資訊清單、拒絕遍歷式封存路徑，並檢查資訊清單中宣告的每個酬載都存在於 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。