Openclaw Backup Optimized

核心功能

OpenClaw Backup (Optimized) 是一套专为 OpenClaw 工作流设计的自动化备份工具，提供完整的系统状态保护机制：

• 完整快照捕获：递归备份 ~/.openclaw 目录，涵盖配置、工作区与历史记录
• 智能分片压缩：将工作区归档拆分为约 90MB 的小文件，配合 SHA256 校验确保传输完整性
• 富媒体通知：通过 Discord 推送备份摘要、文件变更统计及一键恢复指引
• 保留策略管理：自动维护最近 N 份报告，避免存储膨胀

显著优点

| 特性 | 价值 |

|------|------|

| 跨平台兼容 | Node.js 脚本覆盖 macOS/Linux/Windows 三端 |

| 低侵入集成 | 复用 `openclaw message send` 原生通道，无需额外 webhook 配置 |

| 增量感知 | 自动排除 session lock 与已删除文件，生成可读变更摘要 |

| 定时自动化 | 支持 OpenClaw 原生 cron 调度（gateway 环境运行） |

潜在局限

• 依赖门槛：需预装 Node.js ≥18 与 Git，Windows 用户需额外配置 PowerShell 环境变量
• 通知渠道单一：仅支持 Discord，如需 Slack/飞书需二次开发
• 存储成本：分片策略增加文件数量，对象存储场景可能产生更多 PUT 请求费用
• 恢复粒度：全量恢复为主，不支持单文件级细粒度回滚

适合人群

• 使用 OpenClaw 进行日常开发的个人开发者
• 需要定期归档 AI 会话历史与配置的技术用户
• 追求「备份即代码」、偏好 Git 托管备份仓库的 DevOps 爱好者

常规风险

1. 令牌泄露：BACKUP_REPO_URL 若含 personal access token，存在误提交至公共仓库的风险
2. 时区歧义：跨地域协作时，BACKUP_TZ 设置不一致可能导致恢复时间戳混乱
3. cron 漂移：gateway 环境资源紧张时，定时任务可能出现分钟级延迟
4. 分片损坏：任一 90MB 分片校验失败将导致完整归档无法解压，建议配合 S3 版本控制使用

核心功能

OpenClaw Backup 是一款专为 OpenClaw 用户设计的自动化备份工具，提供完整的配置快照与恢复能力。主要功能包括：

1. 全量快照：递归备份 ~/.openclaw 目录，完整保存用户配置与工作区状态
2. 智能分卷：工作区打包后按约 90MB 分割，配合 SHA256 校验，适配 GitHub 等单文件大小限制
3. 变更摘要：自动生成 diff 摘要，排除会话锁与临时文件，减少噪声
4. Discord 集成：通过 openclaw message send 发送富文本通知，附带恢复指令与变更统计
5. 版本控制：自动初始化 Git 仓库、提交并推送到用户指定的远程备份仓
6. 保留策略：可配置保留最近 N 份备份报告，自动清理历史

显著优点

• 开箱即用：单文件脚本，Node.js ≥18 即可运行，跨平台支持 macOS/Linux/Windows
• 原生集成：深度利用 OpenClaw 生态（openclaw cron、openclaw message），无需额外 webhook
• 安全可靠：依赖仅 minimatch 与 tar，无已知 CVE；系统调用受控，无命令注入风险
• 可追溯性：Git 历史完整记录每次备份，支持任意时点回滚

潜在局限

• 环境依赖：需预装 Git 与 Node.js，Windows 用户需额外注意路径配置
• 网络要求：备份推送依赖远程 Git 仓库可用性，无离线缓存机制
• 明文存储：备份包未加密，敏感配置以原始形式存储于 Git 仓库
• T3 来源：个人开发者维护，虽代码审计通过，但长期维护稳定性需关注

适合人群

• 重度 OpenClaw 用户，需跨设备同步配置
• 团队协作场景，需标准化备份与恢复流程
• 对数据安全有基础要求，能接受 Git 托管备份的开发者

常规风险

• Git 凭证安全：BACKUP_REPO_URL 若含 token，需确保环境变量安全，避免泄露
• 仓库权限配置：远程仓库需正确设置访问控制，防止备份数据被未授权访问
• 文件权限管理：建议备份目录设置 0600 权限，避免多用户系统下的信息泄露

使用建议

首次使用前务必验证 Git 仓库地址可信性，建议启用 HTTPS/SSH 传输；如涉及敏感密钥配置，考虑额外加密层；定期检查 BACKUP_MAX_HISTORY 与磁盘空间占用。