webdav-backup

# WebDAV / 本地 备份工具

将 OpenClaw 工作目录与基础配置一起备份到 WebDAV 服务器，或直接备份到本地目录。

## 支持的 WebDAV 服务

- 坚果云 (jianguoyun.com)
- Nextcloud / ownCloud
- 阿里云盘（需 WebDAV 插件）
- 其他标准 WebDAV 服务

## 配置

如果只做本地备份，其实不需要配置 WebDAV。

- 本地默认输出目录：`~/openclaw/output`
- 如需云端同步，再配置 WebDAV 连接信息

### 方式一：openclaw.json（推荐）

编辑 `~/.openclaw/openclaw.json`，在 `skills.entries` 中添加：

```json
{
  "skills": {
    "entries": {
      "webdav-backup": {
        "enabled": true,
        "env": {
          "WEBDAV_URL": "https://dav.jianguoyun.com/dav/",
          "WEBDAV_USERNAME": "your-email@example.com",
          "WEBDAV_PASSWORD": "your-password"
        }
      }
    }
  }
}
```

### 方式二：环境变量

```bash
# 仅在当前 shell 会话中临时设置
export WEBDAV_URL="https://dav.jianguoyun.com/dav/"
export WEBDAV_USERNAME="your-email@example.com"
export WEBDAV_PASSWORD="your-password"
```

> **更安全的建议**：优先把配置写进 `~/.openclaw/openclaw.json`，并确保该文件权限受控；不建议把密码长期明文写入 `~/.bashrc` / `~/.zshrc`。

> **优先级**: 环境变量 > openclaw.json 配置

## 使用方法

### 手动备份

```bash
# 只做本地备份（默认保存到 ~/openclaw/output）
# 默认会备份：workspace + openclaw.json + cron + workspace/config
python3 ~/.openclaw/workspace/skills/webdav-backup/scripts/backup.py --local-only

# 备份默认清单到本地 + WebDAV
python3 ~/.openclaw/workspace/skills/webdav-backup/scripts/backup.py

# 只备份你指定的单个目录/文件
python3 ~/.openclaw/workspace/skills/webdav-backup/scripts/backup.py --source /path/to/data --local-only

# 指定备份文件名前缀
python3 ~/.openclaw/workspace/skills/webdav-backup/scripts/backup.py --name my-backup-2025 --local-only

# 指定本地备份目录
python3 ~/.openclaw/workspace/skills/webdav-backup/scripts/backup.py --local-only --local-dir ~/openclaw/my-backups

# 只上传 WebDAV，不保留本地副本
python3 ~/.openclaw/workspace/skills/webdav-backup/scripts/backup.py --remote-only
``...

# webdav-backup

一个给 OpenClaw 用的备份 skill：支持把 `~/.openclaw` 相关工作区与基础配置打包到本地目录，或同步到 WebDAV。

当前默认本地输出目录：`~/openclaw/output`

## 现在支持什么

- 本地备份
- WebDAV 备份
- 本地 + WebDAV 双备份
- 默认备份清单（不只 workspace，还包含基础配置）
- 默认排除缓存、Git、临时目录、旧 output 等无意义内容
- 从本地备份包恢复到当前目录或指定目录
- 生成 `backup-manifest.json`，方便恢复前先核对内容

## 默认备份内容

不传 `--source` 时，默认备份：

- `~/.openclaw/workspace/`
- `~/.openclaw/openclaw.json`
- `~/.openclaw/cron/`
- `~/.openclaw/workspace/config/`

并额外写入：

- `openclaw/backup-manifest.json`

## 默认排除内容

为了避免备份包臃肿，默认会排除：

- `.git/`
- `.ace-tool/`
- `.clawhub/`
- `__pycache__/`、`*.pyc`
- `node_modules/`
- `.cache/`
- `tmp/`、`temp/`
- `output/`、`outputs/`
- `.DS_Store`

## 常用命令

### 只做本地备份

```bash
python3 ~/.openclaw/workspace/skills/webdav-backup/scripts/backup.py --local-only
```

### 本地 + WebDAV 双备份

```bash
python3 ~/.openclaw/workspace/skills/webdav-backup/scripts/backup.py
```

### 只备份指定目录或文件

```bash
python3 ~/.openclaw/workspace/skills/webdav-backup/scripts/backup.py --source /path/to/data --local-only
```

### 恢复本地最新备份

```bash
python3 ~/.openclaw/workspace/skills/webdav-backup/scripts/backup.py --restore latest
```

### 恢复到指定目录

```bash
python3 ~/.openclaw/workspace/skills/webdav-backup/scripts/backup.py --restore latest --restore-dir ~/restore-test
```

## 配置 WebDAV

可以通过 `~/.openclaw/openclaw.json` 或环境变量配置：

- `WEBDAV_URL`
- `WEBDAV_USERNAME`
- `WEBDAV_PASSWORD`
- `OPENCLAW_LOCAL_BACKUP_DIR`（可选，覆盖默认本地输出目录）

环境变量名统一使用 `WEBDAV_PASSWORD`，不再额外兼容 `WEBDAV_PASS`。

更推荐把 WebDAV 配置写进 `~/.openclaw/openclaw.json`，并控制好文件权限；不建议把密码明文长期写入 shell 启动文件。

## 恢复策略建议

恢复时别一上来就覆盖生产目录。更稳的方式是：

1. 先恢复到独立目录
2. 先看 `backup-manifest.json`
3. 再决定整体恢复还是只挑...