openclaw-checkpoint

核心用法

OpenClaw Checkpoint 是一套基于 Git 的灾难恢复系统，专为 OpenClaw AI 助手用户设计。用户通过 checkpoint-setup 完成首次交互式配置后，即可使用 checkpoint-backup 将当前工作空间状态（SOUL.md 身份配置、MEMORY.md 记忆文件、定时任务、自定义脚本等）推送至私有 GitHub 仓库。checkpoint-restore 支持在新设备上交互式选择历史检查点恢复，或直接使用 --latest 快速还原最新状态。checkpoint-schedule 可配置 15 分钟至每日的自动备份频率，底层使用 macOS launchd 或 Linux cron 实现。

显著优点

无缝跨设备体验：用户可在任意机器上通过 GitHub 认证快速恢复完整的 OpenClaw 工作环境，包括对话历史、个性化配置和自动化任务。安全优先设计：API 密钥、OAuth 令牌等敏感信息通过 .gitignore 明确排除，仅备份用户可控的文本类数据。自动化友好：定时任务配置自动导出为 JSON 备份，恢复时可一键还原 cron 作业。透明可控：所有操作基于标准 Git 工作流，用户可随时查看提交历史、手动回滚或重置整个系统。

潜在缺点与局限性

平台限制：仅支持 macOS 和 Linux，Windows 用户无法使用。单设备并发限制：不支持多设备同时运行 OpenClaw，需手动协调同步时机。密钥管理负担：API 密钥需通过密码管理器手动迁移，无法随备份自动恢复。网络依赖：完全依赖 GitHub 服务可用性，国内用户可能面临连接稳定性问题。数据粒度：基于文件级别的 Git 备份，无法细粒度恢复单条记忆或配置项。

适合的目标群体

• 多设备办公的 OpenClaw 重度用户（家庭/办公室/笔记本切换场景）
• 重视数据主权、希望自建备份方案的技术从业者
• 需要灾难恢复能力的企业团队或自由职业者
• 习惯命令行工具、熟悉 Git 工作流的开发者群体

使用风险

仓库可见性风险：若误将备份仓库设为公开，个人对话历史和身份配置将完全暴露，Skill 已多次警示但仍依赖用户操作正确性。远程脚本风险：快速安装命令使用 curl | bash 模式，虽文档建议审查，但多数用户可能直接执行。GitHub 服务依赖：私有仓库免费额度、API 限流或账户封禁可能导致备份中断。定时任务可靠性：launchd/cron 故障或系统睡眠可能导致备份窗口丢失，需定期 checkpoint-status 验证健康状态。

核心用法

OpenClaw Checkpoint 是一套基于 git 的灾难恢复方案，专为 OpenClaw AI 工作区设计。用户通过 checkpoint-setup 完成首次交互式配置后，即可使用 checkpoint-backup 将身份文件（SOUL.md、IDENTITY.md）、记忆库（MEMORY.md、memory/*.md）、定时任务（自动导出为 JSON）及配置同步至私有 GitHub 仓库。跨设备恢复时，checkpoint-restore 提供向导式流程，支持选择历史版本或 --latest 一键恢复最新状态。

关键命令矩阵：

| 命令 | 场景 |

|------|------|

| `checkpoint-setup` | 首次配置，生成 SSH 密钥、创建 PRIVATE 仓库 |

| `checkpoint-backup` | 手动触发备份，自动附带 cron 任务导出 |

| `checkpoint-schedule hourly` | 启用自动备份（15min/30min/2hours/daily 可选） |

| `checkpoint-restore --latest` | 新机器一键恢复 |

| `checkpoint-status` | 检查同步状态与健康度 |

显著优点

• 零配置迁移：新机器仅需安装技能并执行 checkpoint-restore，即可在数分钟内恢复完整工作环境，包括对话历史、自定义工具、定时任务配置
• 多粒度自动备份：支持从 15 分钟到每日的频率选择，macOS 采用 launchd、Linux 采用 cron，均用户级运行无系统侵入
• 安全意识内置：明确区分备份边界——API 密钥、OAuth Token 等敏感信息被 .gitignore 排除，强制要求 PRIVATE 仓库，并在文档中多次警示公开风险
• 交互式体验优化：restore 流程内置首次使用引导，自动检测 SSH 授权状态，处理未提交变更冲突时提供保存/丢弃/取消三选项

潜在缺点与局限性

• 单点并发限制：文档明确禁止多机器同时运行 OpenClaw，否则可能导致提交冲突或状态不一致
• 数据丢失窗口：默认每小时备份意味着最坏情况下丢失 1 小时工作进度，高频用户需手动调整为 15 分钟
• 密钥恢复盲区：.env.* 文件不纳入版本控制，灾难恢复后必须手动从 1Password 等密码管理器还原 API 密钥
• 平台绑定：仅支持 macOS 与 Linux，Windows 用户无法使用
• GitHub 单点依赖：所有远程操作依赖 GitHub 可用性与个人账号安全，无离线或自托管选项

适合人群

• 在多台 Mac/Linux 设备间切换工作的 OpenClaw 重度用户
• 对 AI 对话连续性有强需求的知识工作者、开发者
• 具备基础 git 操作能力，能理解 PRIVATE 仓库重要性的技术用户
• 需要自动化定时任务（cron）备份与迁移的场景

常规风险

1. 仓库可见性误配：若用户误将备份仓库设为 public，个人记忆、身份配置将完全暴露——文档虽多次警示但无强制技术拦截
2. curl\|bash 供应链风险：快速安装指令 curl ... | bash 存在中间人攻击或仓库被篡改风险，安全建议是先下载审查再执行
3. SSH 密钥管理：推荐 SSH 认证虽免 Token 过期烦恼，但私钥泄露将直接危及整个备份仓库
4. 定时任务静默失败：自动备份写入用户级日志，若未主动 checkpoint-status 检查，可能长期未察觉同步中断
5. 来源可信度：T3 级别（个人开发者 AnthonyFrancis），无企业背书，需用户自行审查代码仓库提交历史