前言¶
在本地使用 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