更新时间:2026-07-08 GMT+08:00
分享

OpenClaw备份与回退

openclaw.json文件是OpenClaw的核心配置文件,包含了AI模型配置、通道信息配置以及网关配置等多项关键信息。L实例支持手动、定时、自动备份openclaw.json配置文件,当该文件修改导致异常时可快速回退到指定历史版本。

前提条件

已部署OpenClaw应用镜像的L实例,更多部署指导请参见OpenClaw最佳实践汇总

操作步骤

  1. 登录Flexus应用服务器L实例控制台
  2. 单击目标L实例资源卡片上的“立即配置”,进入应用详情页面。

    如果页面未显示“立即配置”,请单击资源卡片,进入资源详情页面,在左侧列表中单击“应用详情”。

  3. 单击应用管理中的备份与回退。

  4. 按需选择手动备份或者开启定时备份。

    表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官方文档为准。

  5. 备份完成后,可以在备份文件列表中查看所有的备份文件,支持对备份文件执行以下操作。
    表2 备份文件操作

    操作项

    说明

    操作步骤

    修改备注

    修改备份文件的备注信息。

    单击目标备份备注列的编辑按钮,输入新备注后单击“确定”。

    回退

    将指定历史备份文件恢复为当前配置,并自动重启网关使配置生效,重启期间服务短暂不可用。回退前系统会自动创建当前配置的快照,防止回退失败后无法恢复。

    单击目标备份操作列的“回退”,确认无误后输入“YES”并单击“确定”,系统自动完成配置回退并重启网关。

    删除

    删除指定的备份文件及其元数据,删除后不可恢复。

    单击目标备份操作列的的“删除”,确认无误后输入“DELETE”并单击“确定”。

    如果需要查看备份文件的具体配置内容,请远程登录L实例后在如下目录查看:

    • 手动备份和定时备份的文件存储目录:/var/backups/openclaw/config
    • 自动备份的文件存储目录根据版本的不同,存储路径有所不同。
      • 26.1.30版本:/root/.openclaw/
      • 26.1.30版本之后:/home/openclaw/.openclaw/

常见问题

问题现象

问题原因

解决方法

创建手动备份时提示“手动备份数量已达上限”。

手动备份数量已达到5份上限。

先删除不需要的历史手动备份文件,再重新创建手动备份。

回退操作后提示“配置回退成功但网关重启失败”。

网关重启过程中出现异常。

系统会自动恢复回退前的配置。请检查网关服务状态后手动重启网关。

执行备份时提示“备份操作正在执行中,请稍后重试”。

其他类型的备份操作正在执行中。

等待其他备份操作完成后再重试。

相关文档