openclaw2backup

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

Security Scan

The skill's stated purpose (backup/restore OpenClaw) is plausible, but there are several inconsistencies and missing artifacts (PowerShell scripts are referenced but not included, platform/dependency claims conflict, and it mentions backing up a wallet) that warrant caution before installing or running anything.

Purpose & Capability

The name/description match the instructions: this skill is for backing up and restoring OpenClaw workspaces, Skills, and config. However, the SKILL.md references several PowerShell scripts (quick_backup.ps1, full_backup.ps1, restore_backup.ps1, list_backups.ps1) that are not present in the package, and the README/meta reference a repository and publishing workflow that don't match the package source metadata. These gaps make it unclear whether the skill actually provides the code needed to perform the described operations.

Instruction Scope

Instructions tell the agent or user to run/authorize PowerShell scripts, set ExecutionPolicy to Bypass, restart the OpenClaw Gateway, and back up sensitive items including a 'FluxA Wallet' config. The skill does not include the referenced script files to inspect, and it gives broad operational steps (scheduling, restoring, automatic cleanup). Backing up wallet data is sensitive; instructions show how to bypass execution restrictions, which is a common operational step but increases risk if the underlying scripts are unknown.

Install Mechanism

There is no install spec and no code files to install — this is an instruction-only skill. That reduces risk from arbitrary remote installs, but it also means the runtime behavior depends on external scripts that are not bundled here.

Credentials

The skill declares no required environment variables or credentials, which aligns with a local backup utility. However, it mentions backing up a 'FluxA Wallet' (potentially sensitive data) without describing how credentials or private keys are handled. The lack of declared credential requirements means the skill won't explicitly request secrets, but users should be aware backups may include private data and should be stored securely.

Persistence & Privilege

The skill does not request always:true or persistent privileges. It is user-invocable and allows autonomous model invocation by default (the platform default) but does not request system-wide configuration changes or privileges beyond advising standard backup/restore operations.

What to consider before installing

Proceed carefully. Before installing or running anything: 1) Ask the publisher for the actual script files (quick_backup.ps1, full_backup.ps1, restore_backup.ps1, list_backups.ps1) or a trusted repository URL and verify their contents and checksums. 2) Inspect any scripts for dangerous operations (remote uploads, credential exfiltration, deleting unrelated files) before running. 3) Be cautious about backing up wallet files (FluxA Wallet) — ensure private keys are handled securely and stored encrypted/offline. 4) Note the platform mismatch: the skill claims cross-platform support but depends on Windows-specific PowerShell/.NET framework versions; if you use Linux/macOS, confirm compatibility (PowerShell Core/pwsh). 5) Avoid globally lowering execution policies unless you trust the exact script source; consider running scripts in a controlled/test environment first and keep a manual copy of current configs before restoring. If the maintainer can provide a source repo or the scripts for review, that would materially improve confidence.

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

💡 提示：
   恢复命令：.\restore_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

💡 恢复命令示例：
   .\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 执行策略阻止

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