核心用法
OpenClaw Backup & Restore 是一款专注于数据生命周期管理的运维技能,通过 Git 版本控制实现配置、代理、会话及工作区的完整备份与恢复。用户需先在 openclaw.json 中配置私有仓库地址,随后可通过触发短语或脚本执行备份/恢复操作。
备份流程:执行 backup.sh 脚本,系统读取配置的仓库地址,使用 rsync 将 ${HOME}/.openclaw/ 同步至独立的备份目录(自动排除 node_modules、logs 等临时文件),生成带时间戳的 Git 提交并推送至远程 main 分支。
恢复流程:执行 restore.sh 脚本,从远程仓库克隆或拉取最新备份,反向同步至运行目录,自动重装 Node 依赖并执行 openclaw doctor --yes 修复环境路径,最后需手动重启 Gateway 服务。
显著优点
1. 隔离设计:备份操作在独立目录执行,避免污染生产环境的 .openclaw 运行目录
2. 智能过滤:内置 .gitignore 自动排除大体积依赖和日志,保持仓库精简
3. 版本回溯:Git 历史记录支持任意时间点的状态恢复
4. 迁移友好:新机器仅需配置仓库地址和 SSH 密钥即可完整还原环境
5. 可扩展性:支持通过 Cron 实现定时自动化备份
潜在局限
- 手动重启依赖:恢复后需用户手动执行
openclaw gateway restart,存在操作遗漏风险 - SSH 配置门槛:恢复流程依赖预配置的 SSH 密钥,对新手不够友好
- Git 仓库容量:长期高频备份可能导致仓库膨胀,需定期清理历史
- 实时性限制:非实时同步,最近一次提交后的数据变更可能丢失
- 单点故障:依赖单一 Git 远程仓库,无内置多源冗余机制
适合人群
- 需要在多设备间同步 OpenClaw 环境的开发者
- 重视配置版本化管理的运维人员
- 需要灾难恢复方案的企业用户
- 熟悉 Git 工作流的技术用户
常规风险
- 凭证泄露风险:仓库 URL 存储于本地配置文件,需确保文件权限安全
- 仓库暴露风险:误将备份设为公开仓库可能导致敏感配置泄露
- 覆盖风险:恢复操作会覆盖现有运行目录,未保存的本地变更将丢失
- 依赖完整性:
node_modules排除策略依赖重新安装,网络或 registry 故障时可能恢复失败 - 权限问题:跨系统恢复时 UID/GID 差异可能导致文件权限异常