OpenClaw 备份技能

请使用捆绑脚本 scripts/openclaw-backup.sh 执行实际操作。若已有捆绑脚本覆盖该任务，请勿将备份逻辑内联重写。

适用场景

当用户希望执行以下操作时，可使用本技能：

• 创建本地 OpenClaw 备份；
• 在执行高风险变更前手动创建备份；
• 清理过期的常规备份；
• 调度周期性备份任务；
• 检查或调整保留策略行为。

前提条件

本技能假定满足以下条件：

• Linux 系统；
• Bash 4+；
• 已安装并正常运行 OpenClaw CLI；
• 具备本地文件系统访问权限。

主要命令

• 直接从脚本查看当前 CLI 接口定义：
  • scripts/openclaw-backup.sh --help
• 执行常规备份：
  • scripts/openclaw-backup.sh --backup
• 执行手动备份：
  • scripts/openclaw-backup.sh --manual
• 试运行清理操作（dry-run）：
  • scripts/openclaw-backup.sh --prune --dry-run --keep-hours 24 --keep-days 7 --keep-weeks 4
• 自动执行备份 + 清理：
  • scripts/openclaw-backup.sh --auto --keep-hours 24 --keep-days 7 --keep-weeks 4

推荐的定时执行方案

对于周期性本地备份，推荐的默认配置为：

• scripts/openclaw-backup.sh --auto --keep-hours 24 --keep-days 7 --keep-weeks 4

在 Linux 主机上，若目标是直接本地运行脚本（无需通过聊天界面触发），请使用系统调度器（例如 cron）。

运维说明

当前备份格式包含以下内容：

• 工作区（workspace）内容，包括助手身份与连续性文件（例如 SOUL.md、USER.md、AGENTS.md 及其他工作区级上下文文件）；
• OpenClaw 配置；
• cron 导出文件及人类可读的 cron 摘要；
• 软件版本信息；
• 恢复说明；
• 清单文件（manifest）。

当前备份格式**明确排除**以下内容：

• 工作区内存放的备份存储（仅保留对旧版的兼容支持）；

• 临时产物（temp artifacts）；

• 环境变量 / 系统环境 / 系统覆盖配置；

• 常规归档文件受清理策略约束；手动归档文件则不受常规清理影响；

• 保留策略基于归档文件名中编码的 UTC 时间戳，而非 mtime / ctime；

• 除非调用方显式指定输出目录，否则脚本将自动解析 OpenClaw 工作区/配置路径；

• 若用户需要周期性备份，请在安装或修改定时任务前主动询问确认；

• 关于完整的行为契约、保留模型及归档命名规则，请参阅 references/spec.md。