前言¶
跑 OpenClaw 的開發者通常會積累一批不能丟的東西:配置、工作區、擴展和記憶類文件。手工 tar 或整盤拷貝能救急,但很難長期維持「工作日少寫盤、週末做一次全量、過期自動清理」這類運維節奏,也缺少併發保護與備份後校驗。
下面介紹 SkillHub 上的 openclaw系統自動全量和增量備份(座標 @user_a8fdfe0b/openclaw-full-incremental-backup,版本 2.0.0)。它把全量/增量策略、保留週期和安裝期可指定的備份路徑封裝成 Agent Skill,讓 AI 按文檔幫你落地 OpenClaw 側的自動備份與恢復流程。
這是什麼¶
一句話定位:OpenClaw 全自動備份恢復系統,面向 OpenClaw 環境提供增量備份能力。
- 來源:SkillHub 社區技能(
community),發佈者標識爲user_a8fdfe0b;SkillHub 頁面展示作者爲「湖南橡樹」。 - 分類:
it-ops-security。 - 依賴:
requires_api_key=false,無需額外 API Key。 - 平臺:支持 Linux / macOS;需 Python 3.8+。
官方簡介中的使用場景是:保護 OpenClaw 配置、工作區、擴展、記憶文件,降低誤刪、升級失敗或環境遷移帶來的丟失風險。
核心功能¶
以下能力均來自 SkillHub 官方簡介,未在頁面展開的實現細節不在文中臆測。
- 真正增量:基於
tar --listed-incremental的增量備份(官方文案寫作listed-increural,指 listed incremental 機制)。 - 調度策略:每週六自動全量;工作日執行增量。
- 保留策略:全量與增量分別對應 30 天 / 180 天 保留(具體目錄命名與清理邏輯由 Skill 內說明驅動)。
- 可靠性:防併發鎖、完整性自動校驗;備份前對當前目錄做自動快照。
- 路徑可配:安裝時由用戶指定備份路徑,便於掛載獨立磁盤或 NAS。
安裝與啓用¶
SkillHub 推薦兩種方式:用 CLI 安裝,或把安裝提示詞發給當前 AI Agent。
1. 安裝 SkillHub CLI(若尚未安裝)¶
先確認本機是否已有 skillhub:
command -v skillhub && skillhub --version
未安裝時,可按 SkillHub 安裝文檔執行完整安裝(CLI + 默認 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅裝 CLI 時:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安裝本 Skill 到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前 Agent 實際讀取的 skills 目錄;默認裝到 ./skills/ 可能不會被識別。SkillHub 文檔給出的常見路徑示例:
| 環境 | skills 目錄(示例) |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
安裝命令形式如下(將 <skills目錄> 換成上表對應路徑):
skillhub install @user_a8fdfe0b/openclaw-full-incremental-backup --dir <skills目錄>
也可直接向 Agent 發送 SkillHub 頁面提供的提示詞:
請根據 https://skillhub.cn/install/skillhub.md,安裝 `@user_a8fdfe0b/openclaw-full-incremental-backup`。
安裝完成後,按你所用 Client 的要求重啓或刷新 Agent,使新 Skill 被加載。
3. 啓用時的關鍵輸入¶
官方說明強調:安裝時由用戶指定備份路徑。啓用 Skill 後,應在與 Agent 的對話中明確備份落盤位置(本地目錄、掛載點等),以便與「週六全量 + 工作日增量」策略對齊。
典型用法¶
公開頁面未附帶獨立的 shell 劇本或配置文件樣例;典型用法是 安裝 Skill → 在 Agent 中說明 OpenClaw 環境與備份路徑 → 按 Skill 內 SKILL.md 指引完成備份/恢復與校驗。
可復現的安裝側操作即上一節的 skillhub install 或官方安裝提示詞。備份調度(週六全量、工作日增量)、保留 30/180 天、鎖與完整性校驗等行爲,以 Skill 文檔與 Agent 執行結果爲準;若需改 cron 或路徑,應在對話中寫清約束,避免與默認策略衝突。
適用場景與注意¶
適合誰
- 長期在本機或服務器跑 OpenClaw,需要定期保護配置、工作區、擴展與記憶文件。
- 希望用 listed incremental 降低日常備份 IO,同時保留週期性全量與自動清理。
- 使用 Linux 或 macOS,且環境滿足 Python 3.8+。
限制與注意
- 僅支持 Linux / macOS;Windows 未在官方簡介中列出。
- 備份路徑需在安裝/配置階段明確,並確保磁盤空間與權限滿足全量 + 增量疊加。
- SkillHub 統計(截至頁面展示):評分 100000,下載 1268,安裝 1;社區來源,使用前建議在測試環境先跑一輪恢復驗證。
- 與 Cursor、Codex、Claude Code 等無單獨分叉說明時,差異主要在 skills 目錄路徑,安裝命令相同。
結尾¶
openclaw系統自動全量和增量備份 把 OpenClaw 側「全量 + 增量 + 保留 + 校驗」寫進可安裝的 Agent Skill,減少手寫 tar 與 cron 的重複勞動。若你要爲 OpenClaw 做可恢復的本地備份,可從 SkillHub 安裝 @user_a8fdfe0b/openclaw-full-incremental-backup 並按文檔指定備份路徑。
- SkillHub 頁面:https://www.skillhub.cn/skills/user_a8fdfe0b/openclaw-full-incremental-backup
- API 座標頁:https://api.skillhub.cn/user_a8fdfe0b/openclaw-full-incremental-backup
- 安裝說明:https://skillhub.cn/install/skillhub.md