OpenClaw2026.3.8开始内置backup

Posted on Views:

核心思路很简单：

把 state、config、credentials、workspace 打包成一个 .tar.gz 归档。

1.OpenClaw 2026.3.8 官方备份命令

最简单方式：

1
openclaw backup create

执行后会生成类似：

2026-03-10T12-00-00.000Z-openclaw-backup.tar.gz

默认位置：
当前目录（若在 openclaw 目录内，会自动放到 $HOME）。

2.常用备份参数

2.1完整备份

1
openclaw backup create --verify

作用：

  • 生成备份
  • 自动校验归档完整性

2.2指定备份目录

1
openclaw backup create --output ~/backup/openclaw

2.3只备份配置（最小备份）

1
openclaw backup create --only-config

只包含：

openclaw.json

2.4不备份 workspace

1
openclaw backup create --no-include-workspace

适用于：

  • workspace 很大
  • 只关心 agent 配置

2.5验证备份

1
openclaw backup verify backup.tar.gz

会检查：

  • manifest.json
  • 文件完整性
  • 防止路径穿越攻击。

3.备份内容结构

backup.tar.gz
 ├─ manifest.json
 ├─ state/
 │   └─ ~/.openclaw
 ├─ config/
 │   └─ openclaw.json
 ├─ credentials/
 │   └─ API keys
 └─ workspace/
     └─ agents / skills / memory

核心数据来源：

~/.openclaw

其中重要数据包括：

数据 位置
agent memory ~/.openclaw/agents
配置 ~/.openclaw/openclaw.json
API keys ~/.openclaw/credentials
session agents/*/sessions

4备份恢复

4.1备份示例 cron

1
0 3 * * * openclaw backup create --output /backup/openclaw

4.2恢复过程

1 安装 openclaw
2 解压 backup
3 覆盖 ~/.openclaw
4 启动 gateway

1
2
3
tar -xzf openclaw-backup.tar.gz
cp -r state/.openclaw ~/
openclaw gateway start