OpenClaw Backup Skill
一键备份和恢复 OpenClaw 工作空间、Skills 和配置。
触发词
- "备份 OpenClaw"
- "备份工作空间"
- "恢复备份"
- "创建备份"
- "备份配置"
- "备份技能"
- "完整备份"
- "快速备份"
- "显示备份"
- "列出备份"
- "删除备份"
- "backup openclaw"
- "restore backup"
- "list backups"
能力
1. 快速备份
- 备份核心配置文件
- 备份记忆文件
- 备份 Skills
- 排除 node_modules 和 .git
- 生成时间戳 ZIP 文件
- 自动清理旧备份（保留最近 5 个）
2. 完整备份
- 包含 node_modules
- 包含所有项目文件
- 包含 .git 目录
- 适合迁移到新设备
- 自动清理旧备份（保留最近 3 个）
3. 恢复操作
- 从 ZIP 备份恢复
- 自动备份现有配置（.bak.*）
- 选择性恢复（配置/Skills/记忆）
- DryRun 模式预览
- 验证备份完整性
4. 备份管理
- 列出所有可用备份
- 显示备份详情（大小、文件数、Skills）
- 删除指定备份
- 查看备份清单
配置
在 openclaw.json 中添加：
{
"skills": {
"openclaw-backup": {
"backupDir": "D:\\OpenClaw_Backup",
"keepLastN": 5,
"autoBackup": false,
"autoBackupSchedule": "0 2 * * *"
}
}
}| 参数 | 默认值 | 说明 |
|---|---|---|
| backupDir | D:\\OpenClaw_Backup | 备份文件存储目录 |
| keepLastN | 5 | 保留最近 N 个备份 |
| autoBackup | false | 是否启用自动备份 |
| autoBackupSchedule | "0 2 * * *" | 自动备份 cron 表达式 |
使用示例
快速备份
备份 OpenClaw输出：
📦 OpenClaw 快速备份
======================
📦 备份 Skills...
✅ 74 个文件
📁 备份 Workspace...
✅ 1234 个文件（已排除 node_modules）
⚙️ 备份 OpenClaw 配置...
✅ openclaw.json
💰 备份 FluxA Wallet...
✅ FluxA 配置
📋 生成备份清单...
✅ 清单已生成
🗜️ 压缩备份...
✅ 压缩完成：85.23 MB
🧹 清理临时文件...
✅ 清理完成
🗑️ 清理旧备份（保留最近 5 个）...
✅ 无需清理（当前 3 个备份）
================================
✅ 备份完成！
================================
📦 备份文件：D:\OpenClaw_Backup\OpenClaw_Backup_2026-03-17_15-14-30.zip
📊 文件大小：85.23 MB
📄 文件总数：2345
🧩 Skills 数量：74
💡 提示：
恢复命令：.\
estore_backup.ps1 -BackupZip "D:\OpenClaw_Backup\OpenClaw_Backup_2026-03-17_15-14-30.zip"完整备份
完整备份 OpenClaw恢复备份
从备份恢复 D:\OpenClaw_Backup\OpenClaw_Backup_2026-03-17_15-14-30.zip查看备份列表
显示所有备份输出：
📦 OpenClaw 备份列表
====================
备份目录：D:\OpenClaw_Backup
找到 3 个备份
名称 类型 大小_MB 文件数 Skills 创建时间
---- ---- ------- ------ ------ ----------
OpenClaw_Backup_2026-03-17_15-14-30.zip 快速 85.23 2345 74 2026-03-17 15:14
OpenClaw_Backup_2026-03-17_14-23-41.zip 快速 82.15 2340 74 2026-03-17 14:23
OpenClaw_FullBackup_2026-03-16_10-00-00.zip 完整 2742.46 45946 74 2026-03-16 10:00
💡 恢复命令示例：
.\
estore_backup.ps1 -BackupZip "D:\OpenClaw_Backup\OpenClaw_Backup_2026-03-17_15-14-30.zip"脚本说明
quick_backup.ps1
用途: 快速备份核心文件 参数:
BackupDir(默认：D:\OpenClaw_Backup)KeepLastN(默认：5)
特点:
- 排除 node_modules 和 .git
- 适合日常备份
- 文件大小：~50-100 MB
full_backup.ps1
用途: 完整备份所有内容 参数:
BackupDir(默认：D:\OpenClaw_Backup)KeepLastN(默认：3)
特点:
- 包含所有内容
- 适合设备迁移
- 文件大小：~2-5 GB
restore_backup.ps1
用途: 从备份恢复 参数:
BackupZip(必需): 备份 ZIP 文件路径SkipSkills(可选): 跳过 Skills 恢复SkipWorkspace(可选): 跳过 Workspace 恢复SkipConfig(可选): 跳过配置恢复SkipFluxa(可选): 跳过 FluxA 恢复DryRun(可选): 测试模式，不实际恢复
特点:
- 自动备份现有配置
- 支持选择性恢复
- 支持 DryRun 模式
list_backups.ps1
用途: 列出所有备份 参数:
BackupDir(默认：D:\OpenClaw_Backup)Limit(默认：10)
特点:
- 显示备份详情
- 读取 manifest 信息
- 提供恢复命令示例
依赖
- PowerShell 5.1+
- .NET Framework 4.5+ (用于 ZIP 压缩)
- Windows/Linux/macOS 跨平台支持
注意事项
- 完整备份可能较大（包含 node_modules）
- 建议定期清理旧备份
- 恢复前建议先备份当前状态
- 恢复后需要重启 OpenClaw Gateway
- PowerShell 执行策略需要允许运行脚本
故障排除
PowerShell 执行策略阻止
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process恢复后 Skills 不加载
openclaw gateway restart备份文件过大
使用快速备份模式：
.\quick_backup.ps1版本历史
1.0.0 (2026-03-17)
- ✅ 初始版本发布
- ✅ 快速备份功能
- ✅ 完整备份功能
- ✅ 恢复功能
- ✅ 备份列表功能
- ✅ 自动清理旧备份
- ✅ 选择性恢复
- ✅ DryRun 模式
发布说明
包名: openclaw-backup 版本: 1.0.0 许可证: MIT 仓库: https://github.com/openclaw/skills
发布到 ClawHub
# 登录
clawhub login
# 发布
cd skills/openclaw-backup
clawhub publish
# 验证
clawhub info openclaw-backup更新版本
# 更新 _meta.json 版本号
# 发布
clawhub publish --bump patch # minor/major