龙虾（OpenClaw）升级与备份恢复指南

适用场景：容器镜像升级、迁移服务器、数据损坏恢复。

一、备份内容

备份包位置：

同步数据/龙虾/备份/openclaw-*.tar.gz（每天 04:30，保留 7 份）

包内包含：

- openclaw.json —— 主配置（模型、网关、hooks） - .env —— API 密钥 - config-journal-fingerprint.key —— 配置校验指纹 - agents/ —— 会话数据库 - state/ —— 核心状态库、健康日志 - workspace/ —— 工作区（脚本、记忆、USER.md） - media/ —— 媒体文件 - plugin-skills/ —— 插件技能

不包含：缓存、临时文件、npm 依赖。

二、升级步骤

1. 升级前备份

在龙虾容器内执行：

sh /home/node/.openclaw/workspace/scripts/backup-openclaw.sh

2. 拉新镜像、重建容器

1Panel - 应用 - OpenClaw - 版本升级（或编辑 Compose 换镜像标签）- 重建。

注意：龙虾是 container-image-install 方式部署，不能自我升级，必须在 1Panel 侧换镜像重建。

3. 恢复数据

容器重建后数据卷需要恢复备份内容：

A. 从 DAV 下载最新备份

cd /home/node/.openclaw curl -s -u admin:密码 https://dav.oncmm.com/同步数据/龙虾/备份/最新文件.tar.gz -o /tmp/restore.tar.gz

B. 解压覆盖

tar -xzf /tmp/restore.tar.gz -C /home/node/.openclaw

C. 重启网关

openclaw gateway restart

4. 验证

openclaw status openclaw automations list

三、迁移服务器

1. 旧机器跑 backup-openclaw.sh，下载备份包
2. 新机器 1Panel 装 OpenClaw 应用
3. 解压备份到数据卷
4. 拷贝凭据文件（.dav-backup.env、.1panel.env、.wecom-webhook.url、.imgbed-key，这些不在备份包内）
5. 重建容器，验证

四、只恢复部分

只恢复配置： tar -xzf openclaw-*.tar.gz -C /home/node/.openclaw openclaw.json .env

只恢复工作区： tar -xzf openclaw-*.tar.gz -C /home/node/.openclaw workspace/

只恢复会话数据： tar -xzf openclaw-*.tar.gz -C /home/node/.openclaw agents/ state/

五、注意事项

1. 恢复会覆盖现有配置，不确定时先手动备份一份当前配置
2. 凭据文件不在备份内，迁移时需单独拷贝
3. 挪车/图床是独立容器（car-qr-service），升级龙虾不影响它们
4. 备份里有密钥（.env），保护好备份包
5. 最多保留 7 天，超期旧备份会被覆盖

六、恢复时间预估

- 常规升级：约 5 分钟 - 迁移服务器：约 15-30 分钟 - 数据损坏恢复：10 分钟内