# Openclaw Auto Backup

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

- Skill: `williamwg2025/openclaw-auto-backup` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add williamwg2025/openclaw-auto-backup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/williamwg2025/openclaw-auto-backup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT-0
- Author: williamwg2025 (https://skillmd.com/u/williamwg2025)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/williamwg2025/openclaw-auto-backup

---


# 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. **每季度** - 验证异地备份可用性

## 📁 文件结构

```
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