OpenClaw Backup & Restore

💾 Git 驱动 · 一键备份 · 跨机迁移

通过私有 Git 仓库实现 OpenClaw 配置、代理和会话的自动化备份与恢复,支持跨设备迁移与灾难恢复

收藏
2.6k
安装
1.1k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

OpenClaw Backup & Restore 是一款专注于数据生命周期管理的运维技能,通过 Git 版本控制实现配置、代理、会话及工作区的完整备份与恢复。用户需先在 openclaw.json 中配置私有仓库地址,随后可通过触发短语或脚本执行备份/恢复操作。

备份流程:执行 backup.sh 脚本,系统读取配置的仓库地址,使用 rsync${HOME}/.openclaw/ 同步至独立的备份目录(自动排除 node_moduleslogs 等临时文件),生成带时间戳的 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 差异可能导致文件权限异常

OpenClaw Backup & Restore 内容

scripts文件夹
手动下载zip · 3.5 kB
backup.shtext/x-shellscript
请选择文件