!bin/bash

OpenClaw（通常指 GitHub 上的开源项目，如对话机器人框架）的备份至关重要，因为它通常包含配置、自定义逻辑、训练数据和模型等重要资产。

备份的核心是保护 工作目录 和 配置文件，以下是详细的备份方法和步骤。

核心备份原理

OpenClaw 通常是一个 Python 项目，其核心资产包括：

1. 配置文件：如 config.yml, .env 等。
2. 自定义代码：actions.py, models/, custom_modules/ 等目录。
3. 训练数据：data/nlu.yml, data/stories.yml, data/rules.yml 等。
4. 训练好的模型：models/ 目录下的 .tar.gz 文件。
5. 对话追踪数据库：通常为 SQLite 文件（如 tracker.db）或外部数据库的连接信息。
6. 依赖清单：requirements.txt 或 pyproject.toml。

---

手动备份（推荐给所有用户）

这是最基本、最可靠的方法。

步骤：

1. 定位你的 OpenClaw 项目根目录。

   cd /path/to/your/openclaw_project

2. 创建一个备份目录（例如在用户家目录）：

   mkdir -p ~/openclaw_backups

3. 使用压缩工具打包核心文件：

   # 假设你的项目结构如下，备份除临时文件和大型模型外的所有配置和数据
   # 此命令排除了一些通常不需要备份的大文件和缓存
   tar -czvf ~/openclaw_backups/openclaw_backup_$(date +%Y%m%d_%H%M%S).tar.gz \
     --exclude=./__pycache__ \
     --exclude=./.venv \
     --exclude=./models/*.tar.gz \  # 通常模型可以从数据重新训练，但如果你需要，可以移除这行
     .

   关键提示：建议定期清理 models/ 文件夹中旧的模型文件，只保留最佳模型，以减小备份体积。

4. 安全存储：

   • 将备份文件复制到外部硬盘、NAS 或云存储服务（如 Google Drive, Dropbox, 阿里云 OSS）。
   • 建议使用加密压缩包（如 zip -e 或使用 7z 加密）进行额外保护。

---

使用版本控制系统（推荐给开发者/团队）

这是管理代码和配置变更的最佳实践,能与备份相辅相成。

步骤：

1. 初始化 Git 仓库（如果尚未初始化）：

   cd /path/to/your/openclaw_project
   git init

2. 创建 .gitignore 文件，排除不需要版本控制的文件：

   # .gitignore 示例
   __pycache__/
   *.pyc
   .venv/
   venv/
   models/*.tar.gz   # 不提交大模型文件
   tracker.db        # 不提交数据库文件
   .env              # 不提交包含密码的配置文件
   logs/
   .idea/
   *.log

3. 提交核心代码和配置：

   git add .
   git commit -m "Initial commit: OpenClaw project structure"

4. 设置远程仓库：

   • 在 GitHub, GitLab, Gitee 等平台创建私有仓库。
   • 添加远程地址并推送：

     git remote add origin https://github.com/yourname/your-openclaw.git
     git branch -M main
     git push -u origin main

优势：

• 版本历史：记录每一次配置和数据的变更。
• 协作：便于团队开发。
• 与备份互补：Git 管理“源”，备份包可用于快速恢复整个运行环境（包括模型和数据库）。

---

自动化备份脚本

结合方法一,创建一个定期（如每天）运行的脚本。

示例脚本 backup_openclaw.sh：

# 配置变量
PROJECT_DIR="/home/user/openclaw_project"
BACKUP_DIR="/home/user/openclaw_backups"
BACKUP_NAME="openclaw_backup_$(date +%Y%m%d_%H%M%S).tar.gz"
RETENTION_DAYS=7  # 保留最近7天的备份
# 1. 进入项目目录
cd $PROJECT_DIR
# 2. 创建备份（排除venv和可重新生成的模型）
tar -czf $BACKUP_DIR/$BACKUP_NAME \
  --exclude=./.venv \
  --exclude=./models/*.tar.gz \
  --exclude=./__pycache__ \
  .
# 3. 可选：同步到远程（使用rclone, scp等）
# rclone copy $BACKUP_DIR/$BACKUP_NAME mycloud:/backups/openclaw/
# 4. 清理旧备份
find $BACKUP_DIR -name "openclaw_backup_*.tar.gz" -mtime +$RETENTION_DAYS -delete
echo "备份完成: $BACKUP_NAME"

设置定时任务（Cron）：

1. 给予脚本执行权限：chmod +x backup_openclaw.sh
2. 编辑 crontab：crontab -e
3. 添加一行,例如每天凌晨2点执行：

   0 2 * * * /bin/bash /path/to/backup_openclaw.sh >> /home/user/backup.log 2>&1

---

Docker 环境备份

如果你的 OpenClaw 运行在 Docker 中，策略略有不同。

1. 备份数据卷（Volume）：

   • 找到 OpenClaw 容器使用的数据卷名：docker volume ls
   • 通常名为 openclaw_data 或类似。

     # 创建数据卷备份
     docker run --rm -v openclaw_data:/source -v /host/backup/path:/backup alpine \
     tar -czf /backup/data_volume_$(date +%Y%m%d).tar.gz -C /source .

2. 备份 docker-compose.yml 和相关配置文件：

   cp /path/to/docker-compose.yml ~/backups/
   cp -r /path/to/config/ ~/backups/

3. 备份镜像本身（可选）：

   docker save -o ~/backups/openclaw_image_$(date +%Y%m%d).tar your_openclaw_image:tag

---

恢复流程

无论采用哪种备份方法,恢复都应遵循以下原则：

1. 准备新环境：确保 Python、Docker 等基础环境已就绪。
2. 解压备份文件到目标目录。
3. 还原依赖：

   cd /restored/project
   python -m venv .venv
   source .venv/bin/activate  # Linux/Mac
   # .venv\Scripts\activate   # Windows
   pip install -r requirements.txt

4. 恢复数据库：如果是 SQLite，直接复制 tracker.db 文件即可。
5. 测试启动：

   # 如果是 Rasa 框架的 OpenClaw
   rasa run actions &  # 启动自定义动作服务器（如果有）
   rasa run --enable-api  # 启动主服务

总结建议

• 黄金法则：3-2-1 备份策略，至少保留 3 份备份，使用 2 种不同媒介（如硬盘+云），1 份异地保存。
• 日常使用：方法二（Git） + 方法三（自动化脚本） 是最佳组合。
• 定期验证：每隔一段时间，测试从备份中恢复到一个测试环境，确保备份有效。
• 文档化：将你的备份和恢复流程写成文档，放在团队共享位置。

根据你的具体 OpenClaw 项目结构（建议查看项目根目录的 README.md），可能需要对上述路径和排除项进行微调，核心思想是：备份一切不可轻易重新生成的东西。