openclaw2backup

一键备份和恢复 OpenClaw 工作空间、Skills 及配置，支持快速和完整备份、选择性恢复及备份管理。

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 中添加：

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 表达式

使用示例

快速备份

text

备份 OpenClaw

输出：

text

📦 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

💡 提示：
   恢复命令：.\restore_backup.ps1 -BackupZip "D:\OpenClaw_Backup\OpenClaw_Backup_2026-03-17_15-14-30.zip"

完整备份

text

完整备份 OpenClaw

恢复备份

text

从备份恢复 D:\OpenClaw_Backup\OpenClaw_Backup_2026-03-17_15-14-30.zip

查看备份列表

text

显示所有备份

输出：

text

📦 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

💡 恢复命令示例：
   .\restore_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 跨平台支持

注意事项

1. 完整备份可能较大（包含 node_modules）
2. 建议定期清理旧备份
3. 恢复前建议先备份当前状态
4. 恢复后需要重启 OpenClaw Gateway
5. PowerShell 执行策略需要允许运行脚本

故障排除

PowerShell 执行策略阻止

powershell

Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process

恢复后 Skills 不加载

bash

openclaw gateway restart

备份文件过大

使用快速备份模式：

powershell

.\quick_backup.ps1

版本历史

1.0.0 (2026-03-17)

• ✅ 初始版本发布
• ✅ 快速备份功能
• ✅ 完整备份功能
• ✅ 恢复功能
• ✅ 备份列表功能
• ✅ 自动清理旧备份
• ✅ 选择性恢复
• ✅ DryRun 模式

发布说明

包名: openclaw-backup
版本: 1.0.0
许可证: MIT
仓库: https://github.com/openclaw/skills

发布到 ClawHub

bash

# 登录
clawhub login

# 发布
cd skills/openclaw-backup
clawhub publish

# 验证
clawhub info openclaw-backup

更新版本

bash

# 更新 _meta.json 版本号
# 发布
clawhub publish --bump patch  # minor/major