前言¶
在本地使用 OpenClaw 時,agent 配置、memory 文件、cron 任務等狀態散落在不同目錄,遷移到新機器或發生意外數據丟失時,往往需要手動複製大量文件,容易遺漏或出錯。下面介紹一個能在 Cursor/Claude Code 等環境下直接使用的 Skill,通過 git 將這些狀態同步到遠程倉庫,實現跨機備份和災難恢復。
這是什麼¶
這是一個基於通用 SKILL.md 格式的 Agent Skill,由社區開發者 user_eb189599 維護,版本爲 1.0.1。它使用 git 作爲底層版本控制工具,將 OpenClaw 的 workspace 狀態、agents 配置、memory 文件和 cron 任務備份到遠程倉庫。開發者可以通過它對當前狀態做檢查點(checkpoint),在新機器上恢復,或在兩臺電腦之間遷移配置,同時避免因本地數據丟失造成的工作損失。
核心功能¶
該 Skill 提供以下核心命令:
checkpoint:查看幫助概覽checkpoint-setup:交互式引導完成初始配置checkpoint-backup:執行備份操作checkpoint-restore:恢復狀態,可選擇交互式選擇檢查點或使用--latest恢復最新備份checkpoint-schedule:設置定時自動備份checkpoint-stop:停止定時任務checkpoint-status:查看當前備份狀態checkpoint-init:初始化備份倉庫checkpoint-reset:重置備份狀態
備份內容包含:
- SOUL.md 和 MEMORY.md
- memory 目錄下的所有 memory 文件
- cron 任務(自動備份到 memory/cron-jobs-backup.json)
- agents 目錄(~/.openclaw/agents/)
- 其他配置文件
支持多 agent 備份:
- --workspace-only:僅備份 workspace
- --agents-only:僅備份 agents
- --agent <name>:備份指定 agent
安裝與啓用¶
在支持的 Agent 平臺(如 Cursor、Claude Code、Codex CLI)中,通過社區 Skill 目錄找到該 Skill 並安裝。安裝後,Skill 會自動加載,可直接在對話中使用上述命令。
典型用法¶
- 初始化備份倉庫:在對話中運行
checkpoint-init,按提示完成 git 倉庫配置和遠程地址設置。 - 執行備份:運行
checkpoint-backup,將當前狀態提交到倉庫。 - 設置自動備份:運行
checkpoint-schedule,按提示設置備份間隔。 - 恢復狀態:在新機器上安裝 Skill 後,運行
checkpoint-restore,可選擇具體檢查點或直接恢復最新備份(--latest)。
適用場景與注意¶
適合需要在不同機器間保持 OpenClaw 配置一致的開發者,或希望對工作狀態做定期備份以防範數據丟失的場景。
注意:該 Skill 需要 git 倉庫配置,首次使用需通過 checkpoint-setup 完成交互式引導;cron 任務會自動備份到 memory 目錄下的 cron-jobs-backup.json 文件中。
結尾¶
通過 git 實現 OpenClaw 狀態的集中管理,開發者可以更安心地使用 agent 工具,同時具備快速遷移和災難恢復的能力。官方地址:https://api.skillhub.cn/user_eb189599/123-plus