备份技能

备份并恢复完整的 OpenClaw 安装 —— 包括配置、凭据、工作区（workspace）、记忆（memory）和技能（skills）。

依赖要求

必需： gpg、tar（通常已预装于 Linux 系统中）

可选（用于云上传）：jq、aws（S3/R2）、gsutil/gcloud（GCS）、b2（Backblaze）、rclone（Google Drive）、rsync

环境变量： BACKUP_PASSPHRASE、BACKUP_ENCRYPT、BACKUP_RETAIN_DAYS、BACKUP_STOP_GATEWAY、BACKUP_DIR

凭据文件（在初始化过程中创建，存储于 ~/.openclaw/credentials/backup/）：

• backup-passphrase —— 加密完整备份所必需
• aws-credentials、r2-credentials、b2-credentials、gcs-key.json、rclone.conf —— 按云服务商可选配置

快速开始

# 立即执行一次备份 —— 生成两个文件：完整备份（加密） + 仅工作区备份
~/.openclaw/workspace/skills/backup/scripts/backup.sh

# 将两个备份文件上传至已配置的云存储目标
~/.openclaw/workspace/skills/backup/scripts/upload.sh

# 完整恢复（适用于相同环境或灾难恢复）
~/.openclaw/workspace/skills/backup/scripts/restore.sh ~/backups/openclaw/openclaw-myhost-20260215-full.tar.gz.gpg

# 仅工作区恢复（可在任意环境中执行 —— 仅恢复代理的“大脑”）
~/.openclaw/workspace/skills/backup/scripts/restore.sh ~/backups/openclaw/openclaw-myhost-20260215-workspace.tar.gz

交互式配置

如需引导式配置，请阅读 references/setup-guide.md 并按其中与用户的对话流程操作。该流程将指导您完成加密设置、备份模式选择、调度计划以及云存储目标配置。

手动使用方式

backup.sh —— 创建本地备份

每次运行均生成两个文件：

1. 完整备份（*-full.tar.gz.gpg）—— 包含全部内容（含凭据），经加密处理。适用于相同或相近环境下的灾难恢复。
2. 仅工作区备份（*-workspace.tar.gz.gpg）—— 仅包含 ~/.openclaw/workspace/ 目录（含 memory、skills、files），经加密处理。可在任意环境中安全恢复，且不会影响网关（gateway）配置。此即代理的“大脑”。

# 默认行为：同时生成两个备份文件
./scripts/backup.sh

# 跳过网关停止/重启步骤（用于测试）
BACKUP_STOP_GATEWAY=false ./scripts/backup.sh

备份文件保存至 ~/backups/openclaw/。

upload.sh —— 上传至云存储

# 将最新本地备份上传至所有已配置的云存储目标
./scripts/upload.sh

# 上传指定文件
./scripts/upload.sh /path/to/backup.tar.gz.gpg

restore.sh —— 从备份恢复

# 完整恢复（灾难恢复 —— 替换整个 ~/.openclaw/ 目录）
./scripts/restore.sh openclaw-myhost-20260215-full.tar.gz.gpg

# 仅工作区恢复（仅恢复代理“大脑” —— 保留现有配置与凭据）
./scripts/restore.sh openclaw-myhost-20260215-workspace.tar.gz

# 仅从完整备份中解出工作区内容
./scripts/restore.sh --workspace-only openclaw-myhost-20260215-full.tar.gz.gpg

# 从云存储恢复
./scripts/restore.sh s3://mybucket/openclaw/openclaw-myhost-20260215-workspace.tar.gz

脚本会根据文件名自动识别工作区备份，并在解压前创建一份安全副本。

注意： 仅工作区恢复无需重启网关 —— 代理将在下一次会话中自动加载新文件；而完整恢复会停止并替换整个 ~/.openclaw/ 目录，因此恢复后必须重启网关。

test-backup.sh —— 验证配置有效性

./scripts/test-backup.sh

创建一个微型测试文件，进行加密、上传至所有已配置的目标、验证完整性，最后清理临时文件。退出码为 0 表示全部通过。

配置参考

配置文件位于 ~/.openclaw/workspace/skills/backup/config.json：

环境变量

所有配置项均可通过环境变量覆盖：

凭据管理

存储于 ~/.openclaw/credentials/backup/ 目录下：

• backup-passphrase —— 加密口令
• aws-credentials —— AWS S3 凭据
• r2-credentials —— Cloudflare R2 凭据
• b2-credentials —— Backblaze B2 凭据
• gcs-key.json —— Google Cloud Storage 服务账号密钥
• rclone.conf —— Google Drive 的 rclone 配置文件

安全说明

• 备份默认启用 AES-256 加密（GPG 对称加密）
• 完整模式备份强制要求加密 —— 当 mode=full 时，若未提供口令，脚本将拒绝运行，以避免凭据以明文形式存储
• 仅工作区备份同样被加密 —— 因其包含个人数据（memory、笔记、对话记录等）
• ~/.openclaw/credentials/backup/backup-passphrase 文件应仅对所有者可读（权限模式为 600）
• 首次使用时，务必引导用户设置口令（参见 references/setup-guide.md）
• 若未设置口令，则默认启用便携模式 —— 绝不以明文形式存储凭据
• 本地备份将在设定的保留期后自动清理
• 远程备份永不自动删除（生命周期管理请参阅 references/destinations.md）