OpenClaw(Ubuntu)备份与恢复完整教程

适用于通过以下方式安装的 OpenClaw:

curl -fsSL https://openclaw.ai/install.sh | bash

一、先看这个

:backhand_index_pointing_right: 备份这个目录,就等于备份整个 OpenClaw, 你的所有数据都在:

 /root/.openclaw

二、确认数据目录(先验证)

完整运行数据的目录结构如下:

/root/.openclaw
├── agents
├── credentials
├── memory
├── workspace
├── delivery-queue
├── cron
├── logs
├── openclaw.json
├── .env
└── ...

说明包含:

  • 配置(openclaw.json)
  • 密钥(credentials)
  • 记忆数据(memory)
  • 工作数据(workspace)
  • 任务队列(delivery-queue)

备份它 → 一切都在

恢复它 → 完整还原


三、备份数据 :floppy_disk:

方法一:标准备份(推荐)

sudo tar -czvf openclaw_backup_$(date +%F).tar.gz /root/.openclaw

执行后会生成:

openclaw_backup_2026-03-20.tar.gz

方法二:复制备份(不压缩)

sudo cp -r /root/.openclaw /root/openclaw_backup

四、恢复数据 :repeat_button:

步骤 1:重新安装 OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash

步骤 2:停止 OpenClaw(重要)

sudo pkill -f openclaw

步骤 3:恢复数据

sudo tar -xzvf openclaw_backup_*.tar.gz -C /

步骤 4:修复权限(必须)

sudo chown -R root:root /root/.openclaw

步骤 5:重新启动 OpenClaw

按你原来的启动方式运行即可。


五、常见问题 :warning:

  • 恢复后数据“没了”

原因:

:backhand_index_pointing_right: 运行用户变了(不是 root)

说明:

  • 之前运行在 /root/.openclaw
  • 现在运行在 ~/.openclaw

解决:

要么:

sudo cp -r /root/.openclaw ~/.openclaw
sudo chown -R $USER:$USER ~/.openclaw

要么继续用 root 运行


  • 权限错误 / 无法读取数据

执行:

sudo chown -R root:root /root/.openclaw

  • 备份恢复后程序异常

建议:

sudo pkill -f openclaw

然后重新启动


六、推荐优化(可选)

  • 避免使用 root(更安全)

迁移到普通用户:

sudo cp -r /root/.openclaw ~/.openclaw
sudo chown -R $USER:$USER ~/.openclaw

优点:

  • 不依赖 root
  • 权限更安全
  • 更方便备份

七、一键备份脚本(可选)

创建文件:

nano backup_openclaw.sh

内容:

#!/bin/bash
sudo tar -czvf /root/openclaw_backup_$(date +%F).tar.gz /root/.openclaw
echo "Backup completed"

执行:

chmod +x backup_openclaw.sh
./backup_openclaw.sh