核心用法
ClawDog Backup 是一套专为 OpenClaw 生态系统设计的自动化备份恢复解决方案,采用分层备份策略:
核心层实时备份:通过 inotify 监控 SOUL.md、AGENTS.md、IDENTITY.md、USER.md、TOOLS.md 五个关键配置文件,文件变更即触发自动打包压缩并同步至 OneDrive,确保角色设定与工具配置零丢失。
记忆层定时备份:每周日 UTC 23:00 自动打包 memory/ 目录,保留对话历史与长期记忆,避免累积数据意外损毁。
灵活恢复机制:支持 --core/--memory/--all 三种恢复范围、--date 指定历史版本、--target 自定义目标路径、--dry-run 预演验证,恢复过程采用 cp -n 避免意外覆盖现有文件。
显著优点
1. 分层策略科学:区分高频变动的核心配置与累积型记忆数据,核心层实时保障、记忆层周期归档,平衡安全性与存储成本
2. 零手动干预:inotify 监控实现"文件改即备份",配合 OpenClaw cron 定时任务,形成全自动数据保护闭环
3. 云原生架构:基于 rclone 对接 OneDrive,利用微软云存储的可靠性、版本历史与跨设备访问能力
4. 恢复可控性强:dry-run 预演、日期版本选择、非覆盖写入等多重保护,降低误操作风险
5. 日志完备:四类独立日志文件便于审计与故障排查
潜在局限
- 平台依赖:硬编码 Linux 路径(
/root/.openclaw/),Windows/macOS 需手动适配;rclone 与 inotify-tools 依赖增加部署复杂度 - 单点存储:仅支持 OneDrive 单一云端,无本地冗余或多云策略
- 无加密传输:文档未提及备份文件加密,敏感配置(如身份设定)以明文 tar.gz 形式存储
- 保留策略缺失:未配置自动清理旧备份,长期运行可能导致云端存储膨胀
- 恢复粒度粗:仅支持整层恢复,无法细粒度还原单个记忆文件或配置项
适合人群
- OpenClaw 重度用户:频繁调整角色设定、工具配置,需确保迭代安全
- 多设备工作者:依赖 OneDrive 跨终端同步,需在服务器/本地间迁移环境
- 谨慎型运维者:重视 dry-run 验证与非覆盖恢复机制,追求操作可预期
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 配置泄露 | 备份含敏感身份设定,云端存储若账号泄露则完全暴露 | 启用 OneDrive 个人保管库或 rclone 加密层 |
| 监控中断 | inotify 后台进程崩溃导致核心层漏备 | 配置进程守护或定期 health check |
| 版本混淆 | 手动修改后未验证备份成功,误删后无法找回期望版本 | 定期抽查云端备份完整性 |
| rclone 失效 | Token 过期或 API 变更导致同步失败 | 监控 rclone 退出码,配置告警 |
| 存储超限 | 无自动清理策略,长期累积触发 OneDrive 容量限制 | 手动制定 30/90 天保留规则 |
总体评估:功能聚焦、机制完整,是 OpenClaw 生态中务实的专用备份工具,适合已有 Linux 服务器与 OneDrive 账号的技术用户,生产环境建议叠加加密与 retention policy。