使用 OpenClaw 備份指令：快速建立本地狀態與配置封存檔

寫程式最怕遇到環境突然壞掉，或是換電腦時要重新設定一堆東西。手動複製資料夾不只麻煩，還可能漏掉重要的 session 或金鑰，這時候有個可靠的備份指令就非常重要。

`openclaw backup`

為 OpenClaw 的狀態、設定、憑證、session 以及選用的 workspace 建立本地備份壓縮檔。

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 會改用你的 home 目錄作為預設的備份位置。
現有的備份檔案絕對不會被覆寫。
如果輸出路徑位於來源狀態或 workspace 樹狀結構內，系統會拒絕執行以避免無限循環包含。
openclaw backup verify <archive> 會驗證壓縮檔是否只包含一個根 manifest、拒絕路徑遍歷（traversal-style）的檔案路徑，並檢查 manifest 聲明的每個內容是否確實存在於 tarball 中。
openclaw backup create --verify 會在寫入壓縮檔後立即執行上述驗證。
openclaw backup create --only-config 僅備份目前啟用的 JSON 設定檔。

備份內容包含哪些

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

OpenClaw 本地狀態解析器回傳的狀態目錄，通常是 ~/.openclaw
目前啟用的設定檔路徑
OAuth / 憑證目錄
從目前設定中偵測到的 Workspace 目錄（除非你加上 --no-include-workspace）

如果你使用 --only-config，OpenClaw 會跳過狀態、憑證和 workspace 的偵測，只將目前啟用的設定檔路徑加入備份。

OpenClaw 在建立壓縮檔前會先規範化（canonicalizes）路徑。如果設定、憑證或 workspace 已經位於狀態目錄中，它們就不會被重複當作獨立的頂層來源備份。不存在的路徑會被跳過。

壓縮檔會儲存這些來源樹狀結構中的檔案內容，而內嵌的 manifest.json 則會記錄解析後的絕對來源路徑，以及每個資產在壓縮檔中使用的佈局。

設定檔無效時的行為

openclaw backup 刻意繞過了正常的設定預檢（preflight），這樣在需要災難復原時它依然能幫上忙。因為 workspace 的偵測依賴於有效的設定，所以當設定檔存在但內容無效，且你又開啟了 workspace 備份時，openclaw backup create 現在會直接報錯（fail fast）。

在這種情況下，如果你仍想要部分備份，請重新執行：

openclaw backup create --no-include-workspace

這會保留狀態、設定和憑證的備份範圍，同時完全跳過 workspace 的偵測。

如果你只需要設定檔本身的副本，即使設定檔格式錯誤，--only-config 依然有效，因為它不需要解析設定內容來偵測 workspace。

容量與效能

OpenClaw 不會強制限制備份的大小或單一檔案的大小。

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

存放暫存檔與最終壓縮檔所需的可用空間
掃描大型 workspace 樹狀結構並將其壓縮為 .tar.gz 所需的時間
如果你使用 openclaw backup create --verify 或執行 openclaw backup verify，重新掃描壓縮檔所需的時間
目標路徑的檔案系統行為。OpenClaw 偏好使用不覆寫的硬連結（hard-link）發佈步驟，若檔案系統不支援硬連結，則會退而求其次使用排他性複製（exclusive copy）

大型 workspace 通常是壓縮檔體積的主要來源。如果你想要更小或更快的備份，請使用 --no-include-workspace。

若要建立最小的備份檔，請使用 --only-config。

想要了解更多關於環境設定的問題嗎？歡迎詢問 AI Setup Assistant。

下一步

OpenClaw Expert

還是卡住了？

如果這篇文件沒有解決你的情境，直接問 OpenClaw Expert，拿到可執行步驟。