OpenClaw 自动备份
功能特性
- ✅ 状态检查：异常时自动停止备份并提醒
- ✅ 完整备份：配置文件、skills、agents、workspace、memory、credentials
- ✅ 备份轮转：自动保留最新 N 份，删除旧备份
- ✅ 任意存储：支持 rclone 所有后端（S3/COS/FTP/SFTP/WebDAV等）
- ✅ 定时任务：支持 cron 定时自动备份
快速开始
1. 配置 rclone 远程存储（如已有可跳过）
# 查看现有配置
rclone listremotes
# 添加新配置（如腾讯COS）
rclone config create tencentcos s3 provider TencentCOS \
access_key_id 你的AKID \
secret_access_key 你的KEY \
endpoint cos.ap-shanghai.myqcloud.com
# 添加其他存储（如S3、FTP等）
rclone config create mybackup s3 provider AWS access_key_id xxx secret_access_key xxx
rclone config create myftp ftp host ftp.example.com user myuser password mypass
2. 执行备份
/root/.openclaw/workspace-main/skills/openclaw-backup/scripts/backup.sh \
--remote tencentcos:backup-1252695297/openclaw-backup \
--keep 7
3. 配置定时任务
crontab -e
# 每天凌晨3点自动备份
0 3 * * * /root/.openclaw/workspace-main/skills/openclaw-backup/scripts/backup.sh \
--remote tencentcos:backup-1252695297/openclaw-backup \
--keep 7 >> /var/log/openclaw-backup.log 2>&1
备份内容
| 目录/文件 |
说明 |
默认 |
| openclaw.json |
主配置文件 |
✅ |
| openclaw.json.bak* |
配置文件历史 |
✅ |
| skills/ |
技能目录 (48个) |
✅ |
| agents/ |
Agent配置 (6个) |
✅ |
| workspace* |
工作空间 (5个) |
✅ |
| memory/ |
全局记忆 |
✅ |
| credentials/ |
密钥凭证 |
✅ |
| config-backups/ |
配置备份 |
✅ |
| extensions/ |
插件扩展 |
❌ (太大) |
配置参数
| 参数 |
必填 |
默认值 |
说明 |
--remote |
✅ |
- |
rclone 远程路径，格式：remote:bucket/folder |
--keep |
- |
7 |
保留的备份份数 |
--include-memory |
- |
true |
是否包含 memory/ |
--include-config |
- |
true |
是否包含配置文件和 skills |
--include-workspace |
- |
true |
是否包含所有 workspace |
--include-credentials |
- |
true |
是否包含 credentials |
--include-agents |
- |
true |
是否包含 agents |
--include-extensions |
- |
false |
是否包含 extensions（约836MB） |
--check-only |
- |
false |
仅检查状态，不执行备份 |
常用示例
腾讯COS
--remote tencentcos:bucket-name/openclaw-backup
阿里云OSS
--remote aliyunoss:bucket-name/openclaw-backup
AWS S3
--remote s3:bucket-name/openclaw-backup
FTP/SFTP
--remote ftp:backup-folder
--remote sftp:backup-folder
WebDAV
--remote webdav:backup-folder
检查状态
# 仅检查 OpenClaw 状态
/root/.openclaw/workspace-main/skills/openclaw-backup/scripts/backup.sh --check-only
# 查看远程备份
rclone lsl tencentcos:backup-1252695297/openclaw-backup/
恢复备份
# 1. 下载备份
rclone copy tencentcos:backup-1252695297/openclaw-backup/openclaw-backup-2026-03-25-161836.tar.gz /tmp/
# 2. 解压
cd /root/.openclaw
tar -xzf /tmp/openclaw-backup-2026-03-25-161836.tar.gz
# 3. 重启服务
openclaw gateway restart
依赖
- rclone 已配置远程存储
- openclaw CLI 可用
⚠️ 注意事项
- 首次配置：请先运行
rclone config 配置远程存储
- 密钥凭证：credentials/ 包含敏感信息，请妥善保管备份
- 定时任务：建议设置日志文件便于排查问题
- 磁盘空间：确保本地有足够空间临时存放备份文件（约3MB）
