备份 OpenClaw 配置

概述

本技能提供对全部 OpenClaw 配置文件的自动化备份与恢复功能。它会创建带时间戳的归档包，其中包含完整的 OpenClaw 设置，涵盖主配置、工作区（workspace）、技能（skills）及用户数据。

被备份的内容包括：

• ~/.openclaw/ — 主配置
• ~/.config/openclaw/ — 系统级配置
• ~/.local/share/openclaw/ — 本地数据
• ~/.openclaw/workspace/ — 工作区、技能及记忆（memory）

快速开始

备份您的配置

运行备份脚本：

~/.openclaw/workspace/skills/backup-openclaw-config/scripts/backup_openclaw.sh [输出目录]

示例：

# 备份至默认位置（$HOME/backups/openclaw）
~/.openclaw/workspace/skills/backup-openclaw-config/scripts/backup_openclaw.sh

# 备份至自定义位置
~/.openclaw/workspace/skills/backup-openclaw-config/scripts/backup_openclaw.sh ~/my-backups

输出内容：

• 生成名为 openclaw_backup_YYYYMMDD_HHMMSS.tar.gz 的归档包
• 生成名为 openclaw_backup_YYYYMMDD_HHMMSS.info 的元数据文件
• 显示备份摘要，含文件列表与归档包大小
• 自动删除超过 15 天的旧备份，以节省磁盘空间

从备份中恢复

运行恢复脚本：

~/.openclaw/workspace/skills/backup-openclaw-config/scripts/restore_openclaw.sh 

示例：

~/.openclaw/workspace/skills/backup-openclaw-config/scripts/restore_openclaw.sh 
  ~/backups/openclaw/openclaw_backup_20260306_095000.tar.gz

恢复流程：

1. 读取 .info 文件并显示备份信息
2. 列出所有将被恢复的文件
3. 要求用户明确确认后才继续执行
4. 将现有文件重命名为 .bak 后缀作为备份
5. 将配置恢复至原始路径

恢复完成后：

# 重启 OpenClaw Gateway 以应用更改
systemctl --user restart openclaw-gateway

工作流

备份工作流

1. 检查前提条件

   • 验证备份目录是否存在，或是否可被创建
   • 检查 OpenClaw 相关目录是否存在

2. 构建备份结构

   • 生成唯一的时间戳用于命名备份包
   • 创建临时目录用于暂存文件

3. 复制配置文件

   • 备份 ~/.openclaw/（主配置）
   • 备份 ~/.config/openclaw/（系统配置）
   • 备份 ~/.local/share/openclaw/（本地数据）
   • 跳过不存在的目录（并发出警告）

4. 创建归档包

   • 将全部文件压缩为 .tar.gz 归档包
   • 生成 .info 文件，记录元数据（时间戳、主机名、用户名、大小）

5. 报告结果

   • 显示归档包路径与大小
   • 打印恢复命令供参考
   • 若存在缺失目录，则发出相应警告

恢复工作流

1. 验证备份包

   • 检查归档文件是否存在
   • 从 .info 文件中读取并显示备份信息
   • 列出归档包中的文件内容

2. 安全确认

   • 提示当前配置将被覆盖的风险
   • 列出所有将被恢复的文件
   • 要求用户明确输入 yes 进行确认

3. 备份现有文件

   • 将现有目录重命名为 .bak
   • 在覆盖前保留当前配置

4. 解压并恢复

   • 将归档包解压至临时目录
   • 将文件移回原始路径
   • 恢复 ~/.openclaw/、~/.config/openclaw/ 和 ~/.local/share/openclaw/

5. 完成并通知

   • 显示恢复完成消息
   • 提示重启 Gateway 的命令
   • 说明已创建 .bak 备份文件

典型使用场景

升级前备份

# 升级 OpenClaw 前执行备份
~/.openclaw/workspace/skills/backup-openclaw-config/scripts/backup_openclaw.sh

# 然后执行升级
openclaw update

迁移到新机器

# 在旧机器上：创建备份
~/.openclaw/workspace/skills/backup-openclaw-config/scripts/backup_openclaw.sh

# 将备份归档包传输至新机器（如使用 scp、rsync 等）
scp ~/backups/openclaw/openclaw_backup_*.tar.gz user@new-machine:~/

# 在新机器上：执行恢复
~/.openclaw/workspace/skills/backup-openclaw-config/scripts/restore_openclaw.sh 
  ~/backups/openclaw/openclaw_backup_*.tar.gz

灾难恢复

# 系统故障后从备份恢复
~/.openclaw/workspace/skills/backup-openclaw-config/scripts/restore_openclaw.sh 
  /path/to/backup/openclaw_backup_20260306.tar.gz

# 重启服务
systemctl --user restart openclaw-gateway

配置路径说明

关于具体哪些内容会被备份，请参阅 config-locations.md。

简要总结：

• 主配置：~/.openclaw/ — Gateway 配置、扩展（extensions）、令牌（tokens）
• 工作区：~/.openclaw/workspace/ — 技能（skills）、记忆（memory）、用户数据
• 系统配置：~/.config/openclaw/ — systemd 服务、偏好设置
• 本地数据：~/.local/share/openclaw/ — 缓存（cache）、运行时数据

最佳实践

定期备份

建议定期执行备份，尤其在以下操作之后：

• 安装新技能
• 修改配置文件
• 添加扩展（extensions）
• 进行重要的工作区变更

安全存储

• 备份归档包中包含敏感信息（如令牌、凭据）
• 请将备份存放在安全的位置
• 在高敏感环境中，建议使用 gpg 加密备份
• 切勿公开分享备份归档包

备份验证

创建备份后，请务必验证其完整性：

# 测试解压到临时位置
tar -tzf backup.tar.gz | head

# 验证关键文件是否存在
tar -tzf backup.tar.gz | grep -E "(config.json|AGENTS.md|MEMORY.md)"

故障排查

权限被拒绝

若出现权限错误，请执行：

# 确保脚本具有可执行权限
chmod +x ~/.openclaw/workspace/skills/backup-openclaw-config/scripts/*.sh

# 确保备份目录可写
mkdir -p ~/backups/openclaw
chmod 755 ~/backups/openclaw

恢复后 Gateway 无法启动

若恢复后 Gateway 启动失败，请执行：

# 查看 Gateway 日志
journalctl --user -u openclaw-gateway -n 50

# 如需，从 .bak 恢复
mv ~/.openclaw ~/.openclaw.bad
mv ~/.openclaw.bak ~/.openclaw

systemctl --user restart openclaw-gateway

目录缺失

备份脚本可优雅处理缺失目录的情况：

• 跳过不存在的目录
• 为每个缺失目录输出警告信息
• 仍基于可用数据生成有效的备份