OpenClaw Backup 技能指南

OpenClaw Backup 技能概述

Backup 技能讓你的 OpenClaw 智慧體能夠一鍵快照和恢復整個設定 — 包括技能、命令、設定、MCP 整合、上下文和範本。如果你曾經因為一次錯誤的更新或設定失誤而遺失了可用的設定，這就是你需要的安全網。

OpenClaw 的設定分散在 ~/.claude/ 下的多個目錄和檔案中。手動追蹤哪些內容發生了變化既繁瑣又容易出錯。OpenClaw Backup 技能將整個過程自動化：建立帶時間戳的 tar.gz 歸檔，支援選擇性備份模式，還可以透過 Git、rsync 或 Dropbox、Google Drive 等雲端儲存在多台裝置間同步設定。

典型工作流程：

1. 在安裝新技能前，讓 OpenClaw 備份目前的設定。
2. 智慧體將設定打包成帶時間戳的歸檔檔案，儲存到 ~/openclaw-backups/。
3. 如果出了問題，讓 OpenClaw 從最新備份恢復 — 幾秒鐘就能恢復工作狀態。

這個技能與 Config Guardian 技能搭配使用效果很好，後者可以即時驗證設定變更；也可以配合 1Password 技能安全管理備份中包含的 API 令牌。

Backup 技能安裝前的準備

在安裝 Backup 技能之前，請確保你有：

• OpenClaw 已安裝並執行（v1.0+）
• 足夠的磁碟空間存放備份歸檔（每次快照通常 5–50 MB，取決於技能數量）
• clawhub CLI 已安裝用於技能管理
• Git（選用）— 僅在需要版本控制的備份歷史時需要

驗證你的環境：

# 檢查 OpenClaw 版本
openclaw --version

# 檢查可用磁碟空間
df -h ~/openclaw-backups

# 檢查 clawhub CLI
clawhub --version

如何安裝 Backup 技能

使用一條命令安裝 Backup 技能：

npx clawhub@latest install backup

驗證安裝：

clawhub list

你應該能在已安裝技能列表中看到 backup。透過 clawhub CLI 安裝是最快的方式。

Backup 技能設定指南

Backup 技能開箱即用，預設設定已經很合理。你可以透過環境變數自訂行為。

環境變數設定

# 自訂備份目錄（預設：~/openclaw-backups）
export OPENCLAW_BACKUP_DIR="$HOME/openclaw-backups"

# 最大備份保留數量（預設：7）
export OPENCLAW_BACKUP_RETENTION=7

# 啟用更新前自動備份（預設：true）
export OPENCLAW_BACKUP_AUTO=true

備份內容

技能預設歸檔以下目錄和檔案：

| 路徑 | 內容 | |------|------| | ~/.claude/skills/ | 已安裝的技能定義 | | ~/.claude/commands/ | 自訂命令 | | ~/.claude/settings.json | 智慧體設定和偏好 | | ~/.claude/mcp/ | MCP 伺服器設定 | | ~/.claude/contexts/ | 工作階段上下文 | | ~/.claude/templates/ | 自訂範本 |

快取和日誌檔案會自動排除 — 它們在啟動時會重新產生，只會增加歸檔體積。

重要提示： 備份歸檔可能包含儲存在設定或 MCP 設定中的 API 令牌、密鑰和憑證。請將備份存放在安全位置，絕不要提交到公開儲存庫。

Backup 技能使用範例

1. 建立完整備份

你： 「在我安裝新的 Kubernetes 技能之前，備份我的整個 OpenClaw 設定。」

智慧體建立一個帶時間戳的歸檔（如 openclaw-2026-03-13_1045.tar.gz），包含所有設定檔案。完成後會報告歸檔路徑、檔案大小和項目數量。

2. 選擇性僅備份技能

你： 「只備份我已安裝的技能，我想測試移除幾個。」

智慧體執行僅技能備份，只歸檔 ~/.claude/skills/ 目錄。當你只需要保護技能定義時，這樣更快且檔案更小。

3. 從備份恢復

你： 「更新後出了問題，從我最新的備份恢復。」

智慧體列出可用備份，展示最近一個的時間戳和內容，恢復前請求確認。它會先驗證歸檔完整性，然後停止智慧體、替換目前設定並重啟 — 你的工作狀態就恢復了。

4. 列出和管理備份

你： 「顯示我所有的備份以及它們佔用多少空間。」

智慧體列出備份目錄中的所有歸檔，按日期排序，顯示檔案大小。它會標記超過保留期限的舊備份，並提議清理。

5. 同步備份到遠端

你： 「把我最新的備份推送到 Git 備份儲存庫。」

智慧體將最新歸檔提交到你設定的 Git 儲存庫並推送到遠端。這樣可以獲得版本歷史和多裝置存取 — 在另一台機器上複製儲存庫即可從任何快照恢復。

Backup 安全與最佳實踐

備份歸檔包含你完整的 OpenClaw 設定，其中可能包含敏感資料。請遵循以下準則確保安全：

• 加密敏感備份。 如果你的設定包含 API 密鑰或令牌，在儲存到雲端前加密歸檔。使用 gpg 或你的密鑰管理器。
• 限制檔案權限。 保持備份檔案僅目前使用者可讀：chmod 700 ~/openclaw-backups。
• 永遠不要將備份提交到公開儲存庫。 將 ~/openclaw-backups/ 加入全域 .gitignore 以防意外暴露。
• 輪換舊備份。 設定 OPENCLAW_BACKUP_RETENTION 自動清理舊歸檔。對於大多數場景，保留 7 個備份是合理的預設值。
• 定期驗證恢復。 在真正需要之前測試恢復流程。恢復到暫存目錄以確認歸檔完整性。
• 將 Config Guardian 與 Backup 搭配使用。 Config Guardian 即時驗證變更，而 Backup 提供時間點恢復。兩者結合形成完整的安全網。查看安全檢查清單了解 OpenClaw 通用安全指南。

Backup 常見錯誤與故障排除

"No backups found in ~/openclaw-backups"

備份目錄為空或不存在。

1. 確認目錄存在：

ls -la ~/openclaw-backups

2. 如果你自訂了路徑，檢查 OPENCLAW_BACKUP_DIR 是否設定正確：

echo $OPENCLAW_BACKUP_DIR

3. 讓 OpenClaw 建立第一個備份：「立即備份我的設定。」

"Permission denied when creating backup archive"

備份目錄不可寫入。

# 修復權限
chmod 700 ~/openclaw-backups

# 或建立缺失的目錄
mkdir -p ~/openclaw-backups && chmod 700 ~/openclaw-backups

"Backup archive is corrupted — restore failed"

歸檔在儲存或傳輸過程中損壞。

1. 測試歸檔完整性：

tar -tzf ~/openclaw-backups/openclaw-2026-03-13_1045.tar.gz > /dev/null

2. 如果已損壞，嘗試保留列表中的上一個備份。
3. 對於 Git 同步的備份，檢查舊提交中是否有完好的歸檔：在備份儲存庫中執行 git log --oneline。