OpenClaw备份与回退
openclaw.json文件是OpenClaw的核心配置文件,包含了AI模型配置、通道信息配置以及网关配置等多项关键信息。L实例支持手动、定时、自动备份openclaw.json配置文件,当该文件修改导致异常时可快速回退到指定历史版本。
前提条件
已部署OpenClaw应用镜像的L实例,更多部署指导请参见OpenClaw最佳实践汇总。
操作步骤
- 登录Flexus应用服务器L实例控制台。
- 单击目标L实例资源卡片上的“立即配置”,进入应用详情页面。
- 单击应用管理中的备份与回退。
- 按需选择手动备份或者开启定时备份。
表1 备份操作 备份操作
备份类型
说明
操作步骤
手动备份
手动
- 由用户手动触发,若配置内容未变更则不。
- 手动备份文件最多保留5份,当数量达到上限(5份)时,无法继续创建,需要手动删除历史备份。
单击“手动备份”,填写备注信息后单击“确定”。
定时备份
定时
- 开启后,每日00:00自动执行,若配置内容未变更则跳过,备份文件最多保留7份。
- 定时备份文件最多保留7份,当数量达到上限(7份)时,系统将自动清理最旧的备份。
单击定时备份的按钮,可以开启或关闭定时备份。
- 开启:

- 关闭:

自动备份
自动
- OpenClaw原生的备份能力,对openclaw.json配置文件执行写入操作时,OpenClaw会自动创建名称以openclaw.json.bak开头的备份文件。
- 在创建L实例时,会自动生成5份备份文件。
- 自动备份文件最多保留5份,当数量达到上限(5份)时,OpenClaw会自动清理备份。
访问OpenClaw Web页面,在配置中修改openclaw.json配置文件,保存后会触发自动备份。
其他能触发自动备份的操作请以OpenClaw官方文档为准。
- 备份完成后,可以在备份文件列表中查看所有的备份文件,支持对备份文件执行以下操作。
表2 备份文件操作 操作项
说明
操作步骤
修改备注
修改备份文件的备注信息。
单击目标备份备注列的编辑按钮,输入新备注后单击“确定”。
回退
将指定历史备份文件恢复为当前配置,并自动重启网关使配置生效,重启期间服务短暂不可用。回退前系统会自动创建当前配置的快照,防止回退失败后无法恢复。
单击目标备份操作列的“回退”,确认无误后输入“YES”并单击“确定”,系统自动完成配置回退并重启网关。
删除
删除指定的备份文件及其元数据,删除后不可恢复。
单击目标备份操作列的的“删除”,确认无误后输入“DELETE”并单击“确定”。
如果需要查看备份文件的具体配置内容,请远程登录L实例后在如下目录查看:
- 手动备份和定时备份的文件存储目录:/var/backups/openclaw/config
- 自动备份的文件存储目录根据版本的不同,存储路径有所不同。
- 26.1.30版本:/root/.openclaw/
- 26.1.30版本之后:/home/openclaw/.openclaw/
常见问题
| 问题现象 | 问题原因 | 解决方法 |
|---|---|---|
| 创建手动备份时提示“手动备份数量已达上限”。 | 手动备份数量已达到5份上限。 | 先删除不需要的历史手动备份文件,再重新创建手动备份。 |
| 回退操作后提示“配置回退成功但网关重启失败”。 | 网关重启过程中出现异常。 | 系统会自动恢复回退前的配置。请检查网关服务状态后手动重启网关。 |
| 执行备份时提示“备份操作正在执行中,请稍后重试”。 | 其他类型的备份操作正在执行中。 | 等待其他备份操作完成后再重试。 |

