# OpenClaw备份与回退
openclaw.json文件是OpenClaw的核心配置文件，包含了AI模型配置、通道信息配置以及网关配置等多项关键信息。L实例支持手动、定时、自动备份openclaw.json配置文件，当该文件修改导致异常时可快速回退到指定历史版本。
#### 前提条件
已部署OpenClaw应用镜像的L实例，更多部署指导请参见[OpenClaw最佳实践汇总](https://support.huaweicloud.com/bestpractice-flexusl/flexusl_bp_0001.html)。
#### 操作步骤
1. 登录[Flexus应用服务器L实例控制台](https://console.huaweicloud.com/smb/?/resource/list)。
2. 单击目标L实例资源卡片上的"立即配置"，进入应用详情页面。 如果页面未显示"立即配置"，请单击资源卡片，进入资源详情页面，在左侧列表中单击"应用详情"。
   
3. 单击应用管理中的备份与回退。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002633830668.png "点击放大")
   
4. 按需选择手动备份或者开启定时备份。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002634842722.png "点击放大")
   表1备份操作 
   | 备份操作 | 备份类型 | 说明                                                                                                                                                                                                                                                                                                                                                                                                                 | 操作步骤                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   |:---|:---|:---|:---|
   | 手动备份 | 手动   | - 由用户手动触发，若配置内容未变更则不。  - 手动备份文件最多保留5份，当数量达到上限（5份）时，无法继续创建，需要手动删除历史备份。                                                                                                                                                                    | 单击"手动备份"，填写备注信息后单击"确定"。                                                                                                                                                                                                                                                                                                                                                                                                                    |
   | 定时备份 | 定时   | - 开启后，每日00:00自动执行，若配置内容未变更则跳过，备份文件最多保留7份。  - 定时备份文件最多保留7份，当数量达到上限（7份）时，系统将自动清理最旧的备份。                                                                                                                                                   | 单击定时备份的按钮，可以开启或关闭定时备份。 - 开启：![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002664309785.png)  - 关闭：![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002664189727.png)   |
   | 自动备份 | 自动   | - OpenClaw原生的备份能力，对openclaw.json配置文件执行写入操作时，OpenClaw会自动创建名称以openclaw.json.bak开头的备份文件。  - 在创建L实例时，会自动生成5份备份文件。  - 自动备份文件最多保留5份，当数量达到上限（5份）时，OpenClaw会自动清理备份。   | 访问OpenClaw Web页面，在配置中修改openclaw.json配置文件，保存后会触发自动备份。 其他能触发自动备份的操作请以OpenClaw官方文档为准。                                                                                                                                                                                                                                                                                                                       |
      
   
5. 备份完成后，可以在备份文件列表中查看所有的备份文件，支持对备份文件执行以下操作。
   表2备份文件操作 
   | 操作项  | 说明                                                                  | 操作步骤                                                |
   |:---|:---|:---|
   | 修改备注 | 修改备份文件的备注信息。                                                        | 单击目标备份备注列的编辑按钮，输入新备注后单击"确定"。                        |
   | 回退   | 用历史备份文件恢复配置，并自动重启网关使配置生效，重启期间服务短暂不可用。回退前系统会自动创建当前配置的快照，防止回退失败后无法恢复。 | 单击目标备份操作列的"回退"，确认无误后输入"YES"并单击"确定"，系统自动完成配置回退并重启网关。 |
   | 删除   | 删除指定的备份文件及其元数据，删除后不可恢复。                                             | 单击目标备份操作列的的"删除"，确认无误后输入"DELETE"并单击"确定"。             |
      
   ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/note_3.0-zh-cn.png)
   如果需要查看备份文件的具体配置内容，请远程登录L实例后在如下目录查看：
   - 手动备份和定时备份的文件存储目录：/var/backups/openclaw/config
   
   - 自动备份的文件存储目录根据版本的不同，存储路径有所不同。
     - 26.1.30版本：/root/.openclaw/
     
     - 26.1.30版本之后：/home/openclaw/.openclaw/
      
     
 
#### 常见问题
| 问题现象                      | 问题原因            | 解决方法                            |
|:---|:---|:---|
| 创建手动备份时提示"手动备份数量已达上限"。    | 手动备份数量已达到5份上限。  | 先删除不需要的历史手动备份文件，再重新创建手动备份。      |
| 回退操作后提示"配置回退成功但网关重启失败"。   | 网关重启过程中出现异常。    | 系统会自动恢复回退前的配置。请检查网关服务状态后手动重启网关。 |
| 执行备份时提示"备份操作正在执行中，请稍后重试"。 | 其他类型的备份操作正在执行中。 | 等待其他备份操作完成后再重试。                 |