openclaw-backup

为 OpenClaw Agent 工作区文件（SOUL.md、MEMORY.md、IDENTITY.md、AGENTS.md、TOOLS.md）提供加密备份与恢复功能。使用 tar + openssl（AES-256-CBC）加密和 soul-upload.com API。每次备份自动生成新随机密码（请勿重复使用密码）。当用户需要：(1) 备份或上传代理工作区文件，(2) 恢复或下载之前的备份，(3) 从远程存储删除备份，或 (4) 管理加密的代理持久化数据时使用。

0Star

0Fork

更新于 2026/2/15

获取 Skill 源代码

OpenClaw 备份技能

使用 Claude Code 对 OpenClaw Agent 工作区文件进行自动加密备份与恢复。

概述

本技能提供三个核心功能：

上传备份 - 使用自动生成的密码加密并上传工作区文件到 soul-upload.com
下载备份 - 使用存储的密码从 soul-upload.com 下载并解密备份
删除备份 - 从远程存储删除备份

所有备份均使用 AES-256-CBC 加密（通过 openssl）并采用自动生成的随机密码。每次备份都会生成一个唯一密码，存储在恢复文件中。

系统要求

在执行备份操作前，请确保已安装以下工具：

Python 3.7+（脚本运行环境）
requests 库（pip install requests）
tar（文件归档）
openssl（加密/解密）
curl（HTTP 请求，系统内置）

默认备份文件

如果用户未指定文件，默认备份以下 OpenClaw 工作区文件：

SOUL.md - 代理核心身份与目标
MEMORY.md - 代理记忆与上下文
IDENTITY.md - 代理身份定义
AGENTS.md - 代理配置
TOOLS.md - 工具配置

工作流程 1：上传备份

触发场景

当用户请求备份工作区文件时执行：

"备份我的工作区文件"
"将 SOUL.md 上传到 soul-upload"
"创建我的代理文件的加密备份"
"备份 SOUL.md 和 MEMORY.md"

执行步骤

收集文件列表
- 如果用户指定了文件，则使用用户指定的文件
- 否则，使用默认列表：SOUL.md MEMORY.md IDENTITY.md AGENTS.md TOOLS.md
- 使用 Read 工具验证文件是否存在
执行备份脚本（密码自动生成）
- 定位脚本路径（通常在技能目录的 scripts/backup.py）
- 执行命令时不带 --password 参数（脚本将自动生成）：
```
python3 scripts/backup.py upload \
  --files "SOUL.md MEMORY.md IDENTITY.md"
```
- 脚本自动生成 32 字符随机密码
- 捕获 stdout（JSON 响应）和 stderr（进度信息，包括生成的密码）

处理响应

成功时，脚本输出 JSON：

{
  "backupId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "downloadUrl": "https://soul-upload.com/backup/...",
  "sizeBytes": 12345,
  "sha256": "abc123...",
  "password": "auto-generated-32-char-random-password"
}

解析 JSON 并提取关键信息，包括自动生成的密码

保存恢复信息

使用 Write 工具创建/更新 .openclaw-backup-recovery.txt
关键：将自动生成的密码包含在恢复文件中

格式：

Backup ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Password: auto-generated-32-char-random-password
Download URL: https://soul-upload.com/backup/...
Created: 2024-01-15 10:30:00 UTC
Size: 12.05 KB
SHA256: abc123...
Files: SOUL.md, MEMORY.md, IDENTITY.md
---

追加到文件末尾（保留历史记录）

显示成功消息
- 告知用户备份完成
- 显示备份 ID 和文件大小
- 重要：告知用户密码已自动生成并保存到 .openclaw-backup-recovery.txt
- 警告用户：恢复文件至关重要 - 没有它，备份无法恢复

错误处理

错误场景	检测方式	用户指导
文件未找到	脚本返回错误："Files not found: ..."	列出缺失文件，询问用户是否继续备份其他文件
文件过大	脚本返回错误："Backup size ... exceeds limit ..."	显示实际大小，建议移除大文件或拆分备份
网络错误	脚本返回错误："Network error: ..."	建议检查网络连接，询问是否重试
413 文件过大	脚本返回错误："File too large (413 Payload Too Large)"	提示超出 20MB 限制，建议减小备份大小
加密失败	脚本返回错误："openssl encryption failed: ..."	检查 openssl 是否正确安装

示例对话

用户：备份我的 SOUL.md 和 MEMORY.md
Claude：我将使用自动生成的加密来备份这些文件。
       [执行备份脚本]
       备份完成！
       - 备份 ID：3f8a2b1c-...
       - 大小：45.2 KB
       - 密码：自动生成（32 字符）
       - 恢复信息已保存到 .openclaw-backup-recovery.txt

       重要提示：请妥善保管 .openclaw-backup-recovery.txt！
       它包含恢复此备份所需的密码。

工作流程 2：下载备份

触发场景

当用户请求恢复备份时执行：

"恢复我的备份"
"下载我的最后一个备份"
"恢复备份 [backup-id]"
"从 [download-url] 恢复"

执行步骤

获取备份 ID 和密码
- 检查用户是否提供了备份 ID 或下载 URL
- 如果未提供，使用 Read 工具读取 .openclaw-backup-recovery.txt
- 从文件中提取最新的备份 ID 和密码
- 如果文件不存在或为空，则无法继续（密码未知）
确定输出目录
- 默认：当前工作目录（.）
- 如果用户指定了目录，则使用用户指定的目录
- 警告用户：现有文件可能被覆盖

执行恢复脚本

使用恢复文件中的密码执行命令：

python3 scripts/backup.py download \
  --backup-id "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" \
  --password "password-from-recovery-file" \
  --output-dir "."

捕获 stdout（JSON 响应）和 stderr（进度信息）

处理响应

成功时，脚本输出 JSON：

{
  "success": true,
  "extractedFiles": ["SOUL.md", "MEMORY.md", "IDENTITY.md"],
  "outputDir": "/path/to/output"
}

解析提取的文件列表

验证恢复结果
- 使用 Read 工具读取恢复文件的前几行
- 显示文件预览供用户确认内容正确
- 提醒用户检查完整内容
显示成功消息
- 列出恢复的文件
- 显示输出目录
- 建议用户验证文件内容

错误处理

错误场景	检测方式	用户指导
备份 ID 不存在	脚本返回错误："Backup not found: ..."	检查备份 ID 是否正确，可能已被删除
恢复文件缺失	`.openclaw-backup-recovery.txt` 未找到	无法恢复 - 没有恢复文件，密码未知
密码错误	脚本返回错误："Decryption failed - wrong password ..."	恢复文件可能已损坏或来自不同的备份
网络错误	脚本返回错误："Network error: ..."	建议检查网络连接，询问是否重试
提取失败	脚本返回错误："tar extraction failed: ..."	文件可能已损坏，尝试重新下载

示例对话

用户：恢复我的最后一个备份
Claude：我在 .openclaw-backup-recovery.txt 中找到了最近的备份
       - 备份 ID：3f8a2b1c-...
       - 创建时间：2024-01-15 10:30:00 UTC
       正在下载并解密备份...
       恢复完成！已提取以下文件：
       - SOUL.md
       - MEMORY.md
       - IDENTITY.md
       文件已保存到当前目录，请验证内容是否正确。

工作流程 3：删除备份

触发场景

当用户请求删除远程备份时执行：

"删除我的备份"
"移除备份 [backup-id]"
"从 soul-upload 删除备份"

执行步骤

获取备份 ID
- 检查用户是否提供了备份 ID
- 如果未提供，使用 Read 工具读取 .openclaw-backup-recovery.txt
- 显示可用备份列表供用户选择
- 如果文件不存在或为空，要求用户提供备份 ID
请求确认
- 警告：此操作不可逆，备份将被永久删除
- 显示要删除的备份 ID 和创建时间
- 要求用户确认删除
执行删除脚本
- 用户确认后，执行命令：
```
python3 scripts/backup.py delete \
  --backup-id "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
```
- 捕获 stdout（JSON 响应）和 stderr（进度信息）

处理响应

成功时，脚本输出 JSON：

{
  "success": true,
  "backupId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

更新恢复信息文件
- 使用 Read 工具读取 .openclaw-backup-recovery.txt
- 移除已删除的备份记录（包括其密码）
- 使用 Write 工具保存更新后的文件
- 如果文件变为空，可以删除该文件
显示成功消息
- 确认备份已删除
- 显示已删除的备份 ID
- 提醒用户：如果需要再次备份，必须创建新的备份并生成新密码

错误处理

错误场景	检测方式	用户指导
备份 ID 不存在	脚本返回错误："Backup not found: ..."	备份可能已被删除或 ID 不正确
网络错误	脚本返回错误："Network error: ..."	建议检查网络连接，询问是否重试
用户取消	用户拒绝确认	操作已取消，备份未被删除

示例对话

用户：删除我的备份
Claude：我在 .openclaw-backup-recovery.txt 中找到了以下备份：
       1. 备份 ID：3f8a2b1c-...（2024-01-15 10:30:00）
       2. 备份 ID：7b2c9d4e-...（2024-01-14 08:20:00）
       您想删除哪个备份？（1 或 2）
用户：1
Claude：警告：这将永久删除备份 3f8a2b1c-...
       此操作无法撤销。确认删除？（yes/no）
用户：yes
Claude：备份已删除。
       - 备份 ID：3f8a2b1c-...
       如需再次备份，请创建新的备份并生成新的自动密码。

安全说明

密码策略（新）

自动生成密码：每次备份生成一个唯一的 32 字符随机密码
切勿重复使用密码：根据 soul-upload.com 策略，请勿跨备份重复使用密码
密码存储：密码存储在 .openclaw-backup-recovery.txt 中（解密必需）
用户责任：用户必须妥善保管恢复文件 - 没有它，备份无法恢复

恢复文件安全

文件位置：.openclaw-backup-recovery.txt（工作区根目录）
内容：备份 ID、密码（关键）、下载 URL、时间戳、SHA256
关键：恢复文件是密码的唯一存储位置
建议：
- 如果敏感，添加到 .gitignore
- 或者提交到版本控制以便团队访问
- 考虑将恢复文件本身备份到单独的安全位置

加密算法

算法：AES-256-CBC（对称加密）
加盐：openssl 自动添加盐以增强安全性
兼容性：与 soul-upload.com 官方文档一致

临时文件清理

脚本使用 try-finally 确保临时文件被清理
避免在磁盘上留下未加密的敏感数据

文件大小限制

最大备份大小：20 MB（压缩并加密后）
检查时机：上传前自动检查
超出限制处理：显示实际大小，建议用户：
- 移除大文件（如日志、缓存）
- 拆分备份（分批备份不同文件）

API 参考

soul-upload.com 备份 API：

端点	方法	功能	响应
`/backup`	POST	上传备份	`{backupId, downloadUrl, sizeBytes, sha256}`
`/backup/:backupId`	GET	下载备份	302 重定向到 R2 存储 URL
`/backup/:backupId`	DELETE	删除备份	`{success: true, backupId}`

常见状态码：

200 - 成功
404 - 备份未找到
413 - 文件过大（超过 20MB）
415 - 不支持的文件类型
500 - 服务器错误

故障排除

缺少依赖

问题：脚本错误 "Missing required tools: tar, openssl"

解决方案：

macOS：brew install openssl（tar 内置）
Ubuntu/Debian：sudo apt-get install tar openssl
验证安装：tar --version 和 openssl version

Python requests 库缺失

问题：脚本错误 "Error: 'requests' library not found"

解决方案：

pip install requests
# 或
pip3 install requests

恢复文件丢失

问题：无法恢复备份 - 恢复文件丢失

解决方案：

恢复文件至关重要 - 包含密码的唯一副本
没有恢复文件，备份无法恢复
建议将恢复文件备份到单独的安全位置
如果丢失，备份将永久无法访问

网络超时

问题：上传/下载期间超时

解决方案：

检查网络连接
减小备份文件大小（移除不必要的文件）
脚本默认超时时间为 5 分钟，通常足够

文件已存在

问题：恢复时覆盖现有文件

解决方案：

在恢复前备份现有文件
指定不同的输出目录
手动将现有文件移动到其他位置

使用示例

示例 1：备份所有默认文件

用户：备份我的工作区文件
Claude：[使用默认文件列表执行上传工作流程]
       [自动生成密码并保存到恢复文件]

示例 2：备份特定文件

用户：只备份 SOUL.md 和 MEMORY.md
Claude：[执行上传工作流程，仅备份指定文件]
       [自动生成密码并保存到恢复文件]

示例 3：恢复最新备份

用户：恢复我的最后一个备份
Claude：[从 .openclaw-backup-recovery.txt 读取最新的备份 ID 和密码]
       [执行下载工作流程]

示例 4：恢复特定备份

用户：恢复备份 3f8a2b1c-1234-5678-90ab-cdef12345678
Claude：[从恢复文件中读取此备份 ID 的密码]
       [执行下载工作流程]

示例 5：删除旧备份

用户：删除我的旧备份
Claude：[从恢复文件显示可用备份列表]
       [用户选择要删除的备份]
       [执行删除工作流程]
       [从恢复文件中移除条目]

最佳实践

定期备份：建议每周备份或在重要更改后备份
恢复文件管理：确保 .openclaw-backup-recovery.txt 安全并单独备份
验证恢复：定期测试备份恢复过程以确保备份可用
清理旧备份：定期删除不需要的旧备份以节省存储空间
多副本：考虑将恢复文件保存在多个安全位置

脚本路径

脚本文件位于技能目录的 scripts/backup.py。

执行 Bash 命令时，确保使用正确的相对或绝对路径。通常：

如果当前在技能目录中：python3 scripts/backup.py ...
如果在其他目录中：使用绝对路径或先 cd 到技能目录

参考文档

版本：2.0.0
作者：Claude Code
许可证：MIT
密码策略：每次备份自动生成唯一密码（v2.0.0 新增）

你可能还喜欢

xurl

385Kbackend-api

xurl CLI for authenticated X posts, replies, reads/search, DMs, media upload, followers, auth status, or raw v2 API calls.

steipete

获取

flox-environments

237Kbackend-api

Create reproducible, cross-platform (macOS/Linux) development environments with Flox, a declarative Nix-based environment manager. Use when setting up project toolchains for any language, installing system-level dependencies (compilers, databases, native libs like openssl/BLAS), pinning exact package versions for a team, running local services (PostgreSQL, Redis, Kafka), onboarding developers with one command, or solving 'works on my machine' problems — including agent/vibe-coding setups that need project-scoped tools without sudo. Also use when the user mentions .flox/, manifest.toml, flox activate, or FloxHub.

affaan-m

获取

cloud

107Kbackend-api

Documentation reference for using Browser Use Cloud — the hosted API and SDK for browser automation. Use this skill whenever the user needs help with the Cloud REST API (v2 or v3), browser-use-sdk (Python or TypeScript), X-Browser-Use-API-Key authentication, cloud sessions, browser profiles, profile sync, CDP WebSocket connections, stealth browsers, residential proxies, CAPTCHA handling, webhooks, workspaces, skills marketplace, liveUrl streaming, pricing, or integration patterns (chat UI, subagent, adding browser tools to existing agents). Also trigger for questions about n8n/Make/Zapier integration, Playwright/ Puppeteer/Selenium on cloud infrastructure, or 1Password vault integration. Do NOT use this for the open-source Python library (Agent, Browser, Tools config) — use the open-source skill instead.

browser-use

获取

继续探索

浏览 backend-api 热门 Skills 最近更新

openclaw-backup

相关 Skills

OpenClaw 备份技能

概述

系统要求

默认备份文件

工作流程 1：上传备份

触发场景

执行步骤

错误处理

示例对话

工作流程 2：下载备份

触发场景

执行步骤

错误处理

示例对话

工作流程 3：删除备份

触发场景

执行步骤

错误处理

示例对话

安全说明

密码策略（新）

恢复文件安全

加密算法

临时文件清理

文件大小限制

API 参考

故障排除

缺少依赖

Python requests 库缺失

恢复文件丢失

网络超时

文件已存在

使用示例

示例 1：备份所有默认文件

示例 2：备份特定文件

示例 3：恢复最新备份

示例 4：恢复特定备份

示例 5：删除旧备份

最佳实践

脚本路径

参考文档

你可能还喜欢

xurl

flox-environments

cloud

继续探索