Openclaw Auto Backup

OpenClaw 自动备份技能 - 定时备份配置文件，防止数据丢失。 支持版本管理、一键恢复、定时任务。包含完整 Python 脚本（backup/restore/list/cleanup）。 已通过 ClawHub 多次安全审查（ZipSlip/Symlink/Manifest 修复）。 关键词：openclaw, backup, automation, scheduled, restore, version, config, safety, cron

Auto Backup 技能

自动备份 OpenClaw 配置文件，保护配置安全。

📦 安装

本技能已包含所有脚本文件，无需外部克隆。

bash

# 如果使用 ClawHub 安装（推荐）
npx clawhub install auto-backup

# 或手动添加执行权限
cd ~/.openclaw/workspace/skills/auto-backup
chmod +x scripts/*.py

🔧 配置

备份路径

• 备份存储位置： ~/.openclaw/backups/
• 备份格式： .tar.gz 压缩包
• 命名规则： backup-YYYYMMDD-HHMMSS.tar.gz

备份内容

备份以下配置文件：

• ~/.openclaw/openclaw.json - 主配置文件
• ~/.openclaw/workspace/*.md - 工作区文档
• ~/.openclaw/workspace/skills/ - 技能目录（可选）

📖 使用

手动备份

bash

cd auto-backup
python3 scripts/backup.py --note "配置更新"

查看备份列表

bash

python3 scripts/list.py

恢复备份

bash

python3 scripts/restore.py --version backup-20260310-195545

清理旧备份

bash

python3 scripts/cleanup.py --keep 10  # 保留最近 10 个

⏰ 定时任务

OpenClaw 内置 Cron

技能配置了 OpenClaw 内置定时任务：

• 频率： 每天凌晨 2:00
• 任务 ID： ffbe8fd5-85c0-4261-b8ab-57ed9dc54cf4
• 查看状态： openclaw cron list

系统 Crontab（可选）

如需使用系统 cron：

bash

crontab -e
# 添加：0 2 * * * cd ~/.openclaw/workspace/skills/auto-backup && python3 scripts/backup.py --note 定时备份

🔒 安全说明

安全审计 ✅

v1.0.4 已通过 ClawHub 多次安全审查

已修复的安全问题：

• ✅ ZipSlip 路径遍历漏洞 (v1.0.3) - restore.py 使用安全提取，验证所有路径
• ✅ manifest 文件名不一致 (v1.0.3) - 统一使用 manifest.json
• ✅ 符号链接风险 (v1.0.3) - restore.py 跳过所有符号链接和硬链接
• ✅ backup.py 符号链接处理 (v1.0.4) - 备份时跳过符号链接，防止备份外部文件
• ✅ manifest 路径不一致 (v1.0.4) - backup/restore 统一使用相对路径

备份加密

⚠️ 当前版本不支持加密。备份文件以明文存储。

建议：

• 敏感信息（API Key、密码等）不要放在配置文件中
• 可使用外部工具加密备份目录：

  bash

  # 使用 gpg 加密备份
  gpg -c ~/.openclaw/backups/backup-*.tar.gz
  

存储位置

• 本地存储： 备份仅存储在 ~/.openclaw/backups/
• 路径说明： 使用 ~ 而非 /root，适配不同用户

权限

• 需要权限： 读取 ~/.openclaw/ 目录
• 无需 root： 以当前用户身份运行

网络

• 无网络： 备份过程不联网，不上传任何数据
• 无外部依赖： 不克隆外部仓库，所有脚本已包含

安全最佳实践

备份前检查

bash

# 1. 测试备份（调试模式）
python3 scripts/backup.py --note "test" --debug

# 2. 查看备份列表
python3 scripts/list.py

# 3. 测试恢复（模拟运行）
python3 scripts/restore.py --version backup-20260312-120000 --dry-run

权限设置

bash

# 设置备份目录权限（推荐）
chmod 700 ~/.openclaw/backups

# 不要以 root 身份运行
# 以普通用户身份运行备份

敏感数据保护

bash

# 方法 1: 在 config/backup-config.json 中排除敏感文件
{
  "excludePatterns": ["*.env", "*.key", "secrets/*"]
}

# 方法 2: 使用外部加密
gpg -c ~/.openclaw/backups/backup-*.tar.gz

# 方法 3: 不要将 API Key 等敏感信息放入配置文件
# 使用环境变量代替

定期验证

1. 每周 - 运行一次完整备份 + 恢复测试
2. 每月 - 检查备份文件大小和数量
3. 每季度 - 验证异地备份可用性

📁 文件结构

text

auto-backup/
├── SKILL.md          # 技能说明
├── README.md         # 详细文档
├── config/
│   └── backup-config.json  # 备份配置
└── scripts/
    ├── backup.py     # 备份脚本
    ├── list.py       # 列表脚本
    ├── restore.py    # 恢复脚本
    └── cleanup.py    # 清理脚本

📄 许可证

MIT-0

---

作者： @williamwg2025
版本： 1.0.1
GitHub： https://github.com/williamwg2025/openclaw-auto-backup