openclaw-checkpoint

💾 OpenClaw 跨设备状态同步与灾难恢复

🥥6总安装量 2评分人数 3
100% 的用户推荐

OpenClaw 官方生态的跨设备状态同步工具,通过私有 Git 仓库实现身份、记忆、配置的灾难恢复与无缝迁移。

A

基本安全,请在特定环境下使用

  • 来自可信组织或认证账号,需要结合权限范围判断
  • ✅ 文件访问范围严格限制于 `~/.openclaw/workspace`,不越界访问用户其他数据
  • ✅ 敏感数据(API 密钥、OAuth 令牌、凭证)通过 `.gitignore` 明确排除在备份之外
  • ✅ 仅连接用户自己控制的私有 GitHub 仓库,无第三方服务器通信
  • ⚠️ 提供 `curl | bash` 快速安装方式,虽建议审查但存在潜在社会工程攻击向量
  • ⚠️ 备份内容包含个人对话历史与身份配置,若仓库误设为公开将导致严重隐私泄露

使用说明

核心用法

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 内容

手动下载zip · 10.2 kB
INSTALL.mdtext/markdown
请选择文件