核心功能
webdav-backup 是专为 OpenClaw 设计的备份与恢复工具,采用本地+云端双保险策略。支持将工作目录、配置文件、定时任务等关键数据打包为 tar.gz 压缩包,同时留存本地副本(默认 ~/openclaw/output)并可选同步至 WebDAV 服务器(坚果云、Nextcloud、阿里云盘等)。
显著优点
1. 零配置即可本地备份:不依赖 WebDAV 凭据,开箱即用
2. 智能自动清理:v1.3.0 新增双维度保留策略——本地保留最近7个备份,云端保留最近20个且60天内的备份,避免存储膨胀
3. 灵活恢复机制:支持 latest 快捷恢复、指定文件恢复、临时目录预览,内置 --force 覆盖保护
4. 完整清单备份:不仅包含 workspace,还涵盖 openclaw.json、cron 配置及 manifest 元数据
5. 定时任务友好:专为 OpenClaw cron 设计,支持 agentTurn 隔离会话模式执行
潜在局限与风险
| 类别 | 说明 |
|------|------|
| 传输安全 | WebDAV 密码以明文形式存储于 `openclaw.json` 或环境变量,依赖文件权限控制(建议 `chmod 600`) |
| 依赖风险 | 依赖外部 WebDAV 服务可用性,坚果云等国内服务偶有连接波动 |
| 恢复风险 | `--force` 覆盖操作不可逆,agent 需严格执行"先核对、再落位"原则 |
| 版本兼容 | 备份包跨 OpenClaw 大版本恢复时,配置文件结构可能存在不兼容 |
| 加密缺失 | 备份包本身无加密,敏感数据依赖传输层 HTTPS 和存储端安全 |
适合人群
- 需要定期归档 OpenClaw 工作区的长期用户
- 使用多台设备、希望配置/记忆同步的跨端用户
- 对数据持久性有要求的自动化任务搭建者
- 习惯坚果云/Nextcloud作为个人云存储的 WebDAV 用户
使用建议
1. 首次配置:优先写入 ~/.openclaw/openclaw.json 而非 .bashrc,避免密码泄露至 shell history
2. 定时策略:推荐周一全量备份(本地+云端),周二至周日仅本地增量,平衡安全与带宽
3. 恢复前必做:先恢复到临时目录,核查 backup-manifest.json 内容完整性,确认后再迁移至生产路径