!bin/bash

核心备份原则

1. 定期备份： 根据数据更新频率制定计划（如每日增量、每周全量）。
2. 多地备份： 遵循 3-2-1 原则（至少3份副本，2种不同介质，1份异地/离线）。
3. 验证备份： 定期恢复测试，确保备份文件可用。
4. 自动化： 尽可能使用脚本和定时任务（如 crontab）自动执行。

需要备份的关键数据目录与内容

OpenClaw的典型部署结构下,你需要重点关注以下数据和配置：

备份操作步骤（以典型Linux部署为例）

方案A： 手动备份（适合初期或低频变更）

1. 创建备份目录：

   BACKUP_DIR="/backup/openclaw_$(date +%Y%m%d_%H%M%S)"
   mkdir -p $BACKUP_DIR

2. 备份配置文件：

   cp -r /home/openclaw/config $BACKUP_DIR/
   cp /path/to/docker-compose.yml $BACKUP_DIR/
   cp /path/to/.env $BACKUP_DIR/ 2>/dev/null || true

3. 备份数据库：

   • MySQL：

     mysqldump -u [用户名] -p[密码] --all-databases > $BACKUP_DIR/mysql_backup.sql

   • PostgreSQL (PGVector)：

     pg_dump -U [用户名] -h localhost [数据库名] > $BACKUP_DIR/pg_backup.sql

   • SQLite：

     cp /home/openclaw/data/sqlite.db $BACKUP_DIR/

4. 备份向量数据库：

   • Milvus (需在其容器内执行)：

     docker exec milvus-standalone milvus backup create -n backup_$(date +%s)
     # 然后从容器卷中复制出备份文件

   • Chroma/Weaviate： 参考其文档，通常有导出API或命令。

5. 备份上传文件和知识库：

   tar -czf $BACKUP_DIR/uploads.tar.gz /home/openclaw/uploads/
   tar -czf $BACKUP_DIR/knowledge_base.tar.gz /home/openclaw/knowledge_base/

6. （可选）备份模型清单：

   ls -la /home/openclaw/models/ > $BACKUP_DIR/model_list.txt

7. 打包所有备份：

   cd /backup
   tar -czf openclaw_full_backup_$(date +%Y%m%d).tar.gz openclaw_$(date +%Y%m%d_%H%M%S)/

8. 传输到异地/云存储：

   # 例如使用 rclone 同步到 Google Drive、阿里云OSS等
   rclone copy /backup/openclaw_full_backup_*.tar.gz remote:backup-bucket/openclaw/
   # 或使用 scp
   scp /backup/openclaw_full_backup_*.tar.gz user@remote_server:/backup_location/

方案B： 自动化脚本备份

创建一个脚本 /home/openclaw/scripts/backup.sh：

set -e
BACKUP_ROOT="/backup"
DATE=$(date +%Y%m%d)
BACKUP_DIR="$BACKUP_ROOT/openclaw_$DATE"
# 1. 创建目录
mkdir -p $BACKUP_DIR
# 2. 导出数据库
docker exec openclaw-db mysqldump -u root -p"$DB_PASSWORD" --all-databases > $BACKUP_DIR/db.sql
# 3. 备份配置和文件
cp -r /home/openclaw/config $BACKUP_DIR/
tar --exclude='*.tmp' -czf $BACKUP_DIR/uploads.tar.gz -C /home/openclaw uploads
# 4. 调用向量数据库备份（示例为Milvus）
docker exec milvus-standalone milvus backup create -n backup_$DATE
# 5. 找到并打包Milvus备份文件（假设卷挂载在 /milvus/backup）
tar -czf $BACKUP_DIR/milvus_backup.tar.gz -C /milvus/backup backup_$DATE
# 6. 打包本次所有备份
cd $BACKUP_ROOT
tar -czf openclaw_backup_$DATE.tar.gz openclaw_$DATE/
# 7. 清理7天前的本地备份
find $BACKUP_ROOT -name "openclaw_backup_*.tar.gz" -mtime +7 -delete
find $BACKUP_ROOT -type d -name "openclaw_*" -mtime +7 -exec rm -rf {} \;
# 8. 同步到云存储 (需预先配置好rclone)
/usr/bin/rclone sync $BACKUP_ROOT/openclaw_backup_$DATE.tar.gz remote:backup/openclaw/ --backup-dir=remote:backup/openclaw/old/
echo "Backup completed at $(date)"

设置定时任务（Crontab）：

# 每天凌晨2点执行备份
0 2 * * * /bin/bash /home/openclaw/scripts/backup.sh >> /home/openclaw/logs/backup.log 2>&1

灾难恢复步骤

当需要从备份恢复时,请按顺序操作：

1. 准备新环境： 安装相同的操作系统、Docker等基础依赖。
2. 还原配置文件： 将备份的 config/、docker-compose.yml、.env 放回原路径。
3. 启动基础服务： 启动数据库、向量数据库等容器。

   docker-compose up -d db milvus

4. 恢复数据库：

   cat /backup/db.sql | docker exec -i openclaw-db mysql -u root -p"$DB_PASSWORD"

5. 恢复向量数据库：

   # 将备份文件复制到容器卷
   tar -xzf milvus_backup.tar.gz -C /milvus/backup/
   # 在容器内执行恢复（需指定备份ID）
   docker exec milvus-standalone milvus backup restore -n backup_20241027

6. 恢复应用文件和知识库：

   tar -xzf uploads.tar.gz -C /
   tar -xzf knowledge_base.tar.gz -C /

7. 启动所有服务：

   docker-compose up -d

8. 验证： 登录系统，检查知识库、对话历史等功能是否正常。

重要提示

• 备份前暂停服务： 对于生产环境，为确保数据一致性，建议在备份数据库和向量库前，短暂停止相关写入服务或使用其静默备份功能。
• 加密敏感数据： 如果备份文件会存储在不信任的环境（如公共云），建议对备份包进行加密（如使用 gpg）。
• 版本兼容性： 确保备份恢复的目标环境（尤其是向量数据库和应用程序）与备份源的版本兼容。
• 文档化： 记录你的备份策略、脚本位置、恢复流程和密钥管理方式。

通过遵循本指南,你可以为AI小龙虾OpenClaw系统建立可靠的数据保护机制，最大程度降低数据丢失风险。