Agent Skills
返回列表
OpenClaw 检查点备份恢复

OpenClaw 检查点备份恢复

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_eb189599/123-plus 到当前 AI 助手。

技能介绍

要解决的问题

OpenClaw 的身份、记忆、定时任务和自定义 agent 分散在 ~/.openclaw/workspace、~/.openclaw/agents 与运行时状态中。换机、系统重装或目录误删后，很难完整恢复。这个技能把可迁移的状态打包到私有 Git 仓库，用提交记录形成可回滚的检查点。

工作方式

核心流程是 checkpoint-backup、checkpoint-schedule、checkpoint-restore。备份会收集 SOUL.md、IDENTITY.md、MEMORY.md、TOOLS.md、AGENTS.md 等文件，导出 openclaw cron list --json 为 memory/cron-jobs-backup.json，并把 agent 目录复制进仓库；同时用 .gitignore 排除密钥、凭据和临时文件。跨机器时，$HOME 路径会被替换为 {{HOME}}，恢复时再展开为当前用户目录，避免绝对路径失效。

适用边界

支持 macOS 和 Linux，不支持 Windows。自动备份依赖 macOS launchd 或 Linux cron，需要仓库为私有并建议使用 SSH 认证。该技能不保存 API 密钥、OAuth token 和下载媒体；这些需要密码管理器或重新授权。若需要回滚旧检查点，要注意下一次备份可能覆盖更新的远程提交。

使用场景

  • 在 macOS 新电脑上重建 OpenClaw 工作区，需要从私有 Git 仓库恢复记忆、身份文件和已备份 agents。
  • 修改 SOUL.md 或 memory/*.md 后，先运行 checkpoint-backup 生成可回滚提交，再继续调整配置。
  • 为 OpenClaw 设置每小时自动备份，用 launchd 或 cron 定时把 workspace 和 agents 推到私有仓库。
  • 排查换机后定时任务丢失，检查 memory/cron-jobs-backup.json 是否备份并恢复 cron 配置。

适合人员

  • 维护本地 OpenClaw 助手的工程师：担心换机或重装后丢失身份、记忆和 agents，需要稳定恢复。
  • 使用 OpenClaw cron 自动化的个人开发者：修改 SOUL.md、TOOLS.md 前需要可回滚的检查点。
  • 管理多个 agent 目录的 AI 工作流作者：希望把 ~/.openclaw/agents 同步到私有仓库并跨机恢复。
  • 负责 AI 助手灾备的技术写作者：需要记录恢复流程并避免把密钥写进备份文件。