备份与恢复自动化

基于 rClone 的 OpenClaw 自动化备份与恢复系统。每日备份至 Google Drive，保留最近 20 天的备份历史。

🎯 备份规则（由 Rhandus 制定）

频率与目标：

• 每日执行： 每日一次完整备份
• 目标位置： TU_EMAIL_GOOGLE_DRIVE 对应的 Google Drive
• 保留周期： 最多连续保留 20 天
• 轮转机制： 第 21 天创建新备份时，自动删除第 1 天的备份
• 无累积策略： 始终仅保留 20 个备份

备份目录结构：

Google Drive:/OpenClaw-Backups/
├── backup-2026-02-19/          # 最新备份
├── backup-2026-02-18/
├── ...
├── backup-2026-01-31/          # 第 20 天备份
└── backup-2026-01-30/          # 创建新备份时被自动删除

📋 功能特性

级别 1（基础版）：

• ✅ 每日自动备份（每日 03:00 AM 执行）
• ✅ 20 天自动轮转
• ✅ 完整性校验（基于 checksum）
• ✅ 完整日志记录并支持告警
• ✅ rClone 配置（适配 Google Drive）

级别 2（高级版）：

• 🔄 交互式辅助恢复（CLI 交互模式）
• 📊 可视化仪表盘（展示备份状态）
• 📧 自动报告（成功/失败通知）
• 🔐 可选端到端加密
• ⚡ 增量备份（提升执行速度）

级别 3（智能版）：

• 🧠 关键变更检测
• ⏰ 智能调度（在系统低负载时段执行）
• 📈 存储空间分析与优化
• 🔗 多云集成（Drive + 其他备选云存储）
• 🤖 关键故障自动恢复

🚀 使用方式

主要命令：

backup run

手动触发备份任务。

# 立即执行完整备份
backup run --full

# 仅备份变更内容（增量备份）
backup run --incremental

# 仅备份 OpenClaw 配置文件
backup run --config-only

# 强制执行轮转（删除超过 20 天的备份）
backup run --force-rotate

backup status

查看备份当前状态。

# 显示当前状态摘要
backup status

# 列出所有可用备份
backup status --list

# 校验所有备份完整性
backup status --verify

# 查看已用存储空间
backup status --space

backup recover

从备份中恢复数据。

# 列出所有可恢复的备份
backup recover --list

# 恢复指定日期的备份
backup recover --date 2026-02-19

# 恢复指定文件（来自特定日期备份）
backup recover --file /workspace/MEMORY.md --date 2026-02-18

# 恢复 OpenClaw 配置
backup recover --config

backup config

管理备份系统配置。

# 显示当前配置
backup config --show

# 测试 Google Drive 连接
backup config --test

# 更新认证凭据
backup config --update-credentials

# 修改执行计划（Cron 表达式）
backup config --schedule "0 3 * * *"

⚙️ 配置说明

需包含在备份中的文件：

核心文件（始终备份）：

/home/rhandus/.openclaw/
├── openclaw.json              # 主配置文件
├── agents/                    # Agent 配置目录
├── sessions/                  # 当前活跃会话
└── workspace/                 # Workspace 目录（符号链接）

Workspace（排除非必要内容）：

/workspace/
├── MEMORY.md                  # 长期记忆
├── AGENTS.md                  # Agent 配置
├── SOUL.md                    # 人格定义
├── IDENTITY.md                # 身份信息
├── USER.md                    # 用户信息
├── TOOLS.md                   # 本地工具清单
├── HEARTBEAT.md               # 周期性任务定义
├── skills/                    # 所有 skill 目录
├── openclaw.backup.json       # 备份专用配置
└── .openclaw_contacts.env     # 告警联系人环境变量

排除项（不参与备份）：

**/node_modules/
**/.git/
**/dist/
**/build/
**/vendor/
*.log
*.tmp
*.cache

环境变量：

BACKUP_DRIVE_REMOTE="tiklick-drive"
BACKUP_SOURCE="/home/rhandus/.openclaw /workspace"
BACKUP_EXCLUDE="**/node_modules/ **/.git/"
BACKUP_RETENTION_DAYS=20
BACKUP_SCHEDULE="0 3 * * *"  # 每日 03:00 AM
BACKUP_LOG_FILE="/var/log/openclaw_backup.log"
BACKUP_ALERT_ON_FAILURE=true

🔧 rClone 集成

rClone 配置步骤：

# 创建远程配置
rclone config create tiklick-drive drive 
  client_id "YOUR_CLIENT_ID" 
  client_secret "YOUR_CLIENT_SECRET" 
  scope "drive.file" 
  root_folder_id "YOUR_ROOT_FOLDER_ID"

# 测试连接
rclone lsd tiklick-drive:

# 创建备份根目录
rclone mkdir tiklick-drive:OpenClaw-Backups

基础备份命令：

rclone sync 
  --progress 
  --exclude "**/node_modules/" 
  --exclude "**/.git/" 
  --exclude "*.log" 
  --backup-dir "tiklick-drive:OpenClaw-Backups/backup-$(date +%Y-%m-%d)" 
  /home/rhandus/.openclaw 
  tiklick-drive:OpenClaw-Backups/current

🎯 Tiklick 示例场景

每日自动备份：

# 由 cron 在每日 03:00 AM 执行
backup run --full --rotate --notify

每周完整性校验：

# 每周日 04:00 AM 执行
backup status --verify --report

快速恢复：

# 恢复关键配置（使用昨日备份）
backup recover --config --date $(date -d "yesterday" +%Y-%m-%d)

# 恢复特定 skill
backup recover --file /workspace/skills/alerting-system --date 2026-02-19

存储空间监控：

# 当已用空间超过 80% 时触发告警
backup status --space --alert-if-over 80

📊 指标与监控

需持续跟踪的关键指标：

• 单次备份耗时： < 15 分钟
• 成功率： > 99%
• 已用空间： < 50GB
• 轮转准确性： 精确维持 20 个备份
• 完整性校验通过率： 100% 备份均通过校验

状态仪表盘内容：

• 近 20 天备份状态（绿色/红色标识）
• Google Drive 已用空间
• 上一次备份完成时间
• 完整性校验结果
• 下一次轮转计划时间

🛡️ 安全保障

数据保护措施：

• 访问控制： 仅限 TU_EMAIL_GOOGLE_DRIVE 访问
• 可选加密： 使用 rClone crypt backend 实现端到端加密
• 安全日志： 日志中不记录任何敏感数据
• 操作审计： 完整记录所有备份/恢复操作

灾难恢复流程：

1. 备份损坏： 回退至倒数第二个有效备份
2. Google Drive 不可达： 立即触发告警
3. 主机系统宕机： 从最新已验证备份中恢复
4. 认证凭据泄露： 立即轮换凭据

🔄 维护计划

每日维护：

• 确认夜间备份是否成功完成
• 检查日志中是否存在错误或警告
• 验证轮转是否正确（确保恰好为 20 个备份）

每周维护：

• 对全部 20 个备份执行完整性校验
• 清理超过 30 天的历史日志
• 检查 Google Drive 可用空间

每月维护：

• 执行全系统审计
• 开展端到端恢复演练
• 升级 rClone 及相关依赖
• 审查并优化排除规则（exclusion rules）

🚨 实施路线图

第 1 周：基础功能（当前阶段）

• rClone 与 Google Drive 配置完成
• 实现基础备份脚本，支持 20 天轮转
• 部署日志系统与告警机制
• 完成初步功能测试

第 2 周：高级功能

• 开发交互式 CLI 恢复工具
• 构建可视化状态仪表盘
• 实现邮件自动报告（成功/失败）
• 对接现有告警系统

第 3 周：智能功能

• 实现智能增量备份逻辑
• 引入关键变更检测能力
• 开发关键故障自动恢复模块
• 优化存储空间占用与备份性能

当前状态： 🟢 生产环境（v1.0.0）
作者： Rhandus Malpica
公司： Tiklick
官网： https://tiklick.com
许可证： MIT
发布平台： ClawHub，2026-02-20