openclaw backup:归档、SQLite 快照与 Git 历史三种备份路径
备份有三条互补的路径:整包归档带走状态与凭证,SQLite 快照只抓单个库且可校验,Git 历史则提供可对比的版本序列。归档可以在网关运行时创建,但涉及 PostgreSQL 的恢复要求先停网关。
备份的对象到底是哪些东西
openclaw backup 的归档涵盖 OpenClaw 的状态、配置、认证配置、渠道与提供商的凭证、会话,以及可选的工作区。它可以存在本地,也可以上传到命名好的存储位置。除此之外还有两条更聚焦的路径:SQLite 快照面向单个数据库,Git 历史面向「可对比的版本序列」。三者不是替代关系,而是覆盖不同的恢复场景。
归档:创建、校验、还原
最基本的动作是创建归档,可以用输出目录指定落点,也可以先预演并输出 JSON 看会带上哪些路径——在重置或卸载之前先确认包含范围,这一步比事后追悔有用。创建时可以选择是否包含工作区,也可以只要配置;要更保险就加上校验选项,让创建过程顺带验证归档完整性。
上传到远端时可以带保留策略:按日、按周、按月各留多少份。这三条策略回答的是「出问题时最多能回到多久以前」,而不是磁盘占用的优化项,因此要按业务的容忍度来定,而不是按容量来定。之后可以用列表与校验命令按来源查看与验证,校验可以针对最新的那一份,也可以针对具体某个归档文件。还原时指定目标目录,命令会把归档解开到那里,而不是直接覆盖当前安装——这个设计让你可以先解到临时目录核对内容。
路径处理上有几处细节:引号包裹的归档路径与还原目标会保留文件名首尾的空白;必填路径不能为空;波浪号按有效的主目录展开。报告类输出会剥掉终端转义序列,并把内嵌的换行、制表与回车显示成可见的转义形式,避免终端被归档里的奇怪文件名搞乱;但归档路径本身、被还原的数据与 JSON 输出保留原值。
运行时能不能备份
这是备份里最需要弄清楚的一点。归档创建可以在网关正常服务请求时进行,包括上传到远端的情况;每个受管数据库都经由它自己的物理引擎导出,PostgreSQL 存储各自从一个可重复读的只读快照导出。多个库是依次捕获的,不是在同一瞬间统一取快照,因此某个库快照之后提交的行属于下一次备份。如果需要严格的时间点一致性,就得在网关停止时做,那时命令持离线独占。
而还原、Git 备份、以及选中 PostgreSQL 的通用本地快照,都要求网关先停:命令在网关运行时直接拒绝,并提示通过服务管理方停止后再重跑。混合引擎的安装共用同一套命令与归档格式,备份行为由每个库自身的物理引擎与所选的共享连接决定,只看默认引擎会判断错。
SQLite 快照:更小、更快、可单独校验
SQLite 路径直接对单个库做紧凑快照,可以指定全局库或某个智能体的库,并落到一个仓库目录里。它有创建、列表、校验、还原四个动作,校验还可以指定一个临时目录作为工作区,用于在不污染正式目录的前提下验证快照可读。还原时指定目标文件,而不是覆盖正在使用的库。对只想定期留一份数据库副本、又不想每次都打整包归档的场景,这条路径更合适。
Git 历史:把备份变成可对比的版本
Git 路径先在一个仓库目录里初始化,可以顺便配置一个私有远端;之后每次创建可以选全部或某个智能体,并直接推送。它的价值不止是「有备份」,而是每次提交都可 diff、可回溯到具体某次变更,配合日志命令能看到备份序列。校验与还原同样按全局或指定智能体进行,还原落到目标文件。这条路径适合放在运维自己掌控的私有仓库里,而不是公开托管。
定时与外部记录
定时备份用启用命令配置:可以按 Git 仓库加周期与是否推送,也可以按远端存储加周期与保留策略,周期形如每 24 小时。关掉时区分是关远端还是全部关掉。如果你的备份实际由外部工具(例如系统级快照或第三方备份软件)执行,可以用记录命令把状态、目标与字节数写进 OpenClaw 的备份记录,这样「备份是否跑过」这件事在同一个地方就能看到,而不必去翻另一套系统的日志。
实践建议是把两条路径叠起来用:每日的 SQLite 或 Git 做细粒度回滚,每周的整包归档做灾难恢复,归档里带配置与凭证,才能在换机时一次装回去。只做前者,换机时还得手工重建凭证;只做后者,日常误删一次就要恢复整包。