OpenClaw Backup 技能指南

OpenClaw Backup 技能概述

Backup 技能让你的 OpenClaw 智能体能够一键快照和恢复整个配置 — 包括技能、命令、设置、MCP 集成、上下文和模板。如果你曾经因为一次错误的更新或配置失误丢失了可用的设置，这就是你需要的安全网。

OpenClaw 的配置分散在 ~/.claude/ 下的多个目录和文件中。手动追踪哪些内容发生了变化既繁琐又容易出错。OpenClaw Backup 技能将整个过程自动化：创建带时间戳的 tar.gz 归档，支持选择性备份模式，还可以通过 Git、rsync 或 Dropbox、Google Drive 等云存储在多台设备间同步配置。

典型工作流程：

1. 在安装新技能前，让 OpenClaw 备份当前设置。
2. 智能体将配置打包成带时间戳的归档文件，保存到 ~/openclaw-backups/。
3. 如果出了问题，让 OpenClaw 从最新备份恢复 — 几秒钟就能恢复工作状态。

这个技能与 Config Guardian 技能搭配使用效果很好，后者可以实时验证配置变更；也可以配合 1Password 技能安全管理备份中包含的 API 令牌。

Backup 技能安装前的准备

在安装 Backup 技能之前，请确保你有：

• OpenClaw 已安装并运行（v1.0+）
• 足够的磁盘空间存放备份归档（每次快照通常 5–50 MB，取决于技能数量）
• clawhub CLI 已安装用于技能管理
• Git（可选）— 仅在需要版本控制的备份历史时需要

验证你的环境：

# 检查 OpenClaw 版本
openclaw --version

# 检查可用磁盘空间
df -h ~/openclaw-backups

# 检查 clawhub CLI
clawhub --version

如何安装 Backup 技能

使用一条命令安装 Backup 技能：

npx clawhub@latest install backup

验证安装：

clawhub list

你应该能在已安装技能列表中看到 backup。通过 clawhub CLI 安装是最快的方式。

Backup 技能配置指南

Backup 技能开箱即用，默认配置已经很合理。你可以通过环境变量自定义行为。

环境变量设置

# 自定义备份目录（默认：~/openclaw-backups）
export OPENCLAW_BACKUP_DIR="$HOME/openclaw-backups"

# 最大备份保留数量（默认：7）
export OPENCLAW_BACKUP_RETENTION=7

# 启用更新前自动备份（默认：true）
export OPENCLAW_BACKUP_AUTO=true

备份内容

技能默认归档以下目录和文件：

| 路径 | 内容 | |------|------| | ~/.claude/skills/ | 已安装的技能定义 | | ~/.claude/commands/ | 自定义命令 | | ~/.claude/settings.json | 智能体设置和偏好 | | ~/.claude/mcp/ | MCP 服务器配置 | | ~/.claude/contexts/ | 会话上下文 | | ~/.claude/templates/ | 自定义模板 |

缓存和日志文件会自动排除 — 它们在启动时会重新生成，只会增加归档体积。

重要提示： 备份归档可能包含存储在设置或 MCP 配置中的 API 令牌、密钥和凭证。请将备份存放在安全位置，绝不要提交到公开仓库。

Backup 技能使用示例

1. 创建完整备份

你： "在我安装新的 Kubernetes 技能之前，备份我的整个 OpenClaw 设置。"

智能体创建一个带时间戳的归档（如 openclaw-2026-03-13_1045.tar.gz），包含所有配置文件。完成后会报告归档路径、文件大小和项目数量。

2. 选择性仅备份技能

你： "只备份我已安装的技能，我想测试删除几个。"

智能体执行仅技能备份，只归档 ~/.claude/skills/ 目录。当你只需要保护技能定义时，这样更快且文件更小。

3. 从备份恢复

你： "更新后出了问题，从我最新的备份恢复。"

智能体列出可用备份，展示最近一个的时间戳和内容，恢复前请求确认。它会先验证归档完整性，然后停止智能体、替换当前配置并重启 — 你的工作状态就恢复了。

4. 列出和管理备份

你： "显示我所有的备份以及它们占用多少空间。"

智能体列出备份目录中的所有归档，按日期排序，显示文件大小。它会标记超过保留期限的旧备份，并提议清理。

5. 同步备份到远程

你： "把我最新的备份推送到 Git 备份仓库。"

智能体将最新归档提交到你配置的 Git 仓库并推送到远程。这样可以获得版本历史和多设备访问 — 在另一台机器上克隆仓库即可从任何快照恢复。

Backup 安全与最佳实践

备份归档包含你完整的 OpenClaw 配置，其中可能包含敏感数据。请遵循以下准则确保安全：

• 加密敏感备份。 如果你的配置包含 API 密钥或令牌，在存储到云端前加密归档。使用 gpg 或你的密钥管理器。
• 限制文件权限。 保持备份文件仅当前用户可读：chmod 700 ~/openclaw-backups。
• 永远不要将备份提交到公开仓库。 将 ~/openclaw-backups/ 添加到全局 .gitignore 以防意外暴露。
• 轮换旧备份。 设置 OPENCLAW_BACKUP_RETENTION 自动清理旧归档。对于大多数场景，保留 7 个备份是合理的默认值。
• 定期验证恢复。 在真正需要之前测试恢复流程。恢复到临时目录以确认归档完整性。
• 将 Config Guardian 与 Backup 配合使用。 Config Guardian 实时验证变更，而 Backup 提供时间点恢复。两者结合形成完整的安全网。查看安全检查清单了解 OpenClaw 通用安全指南。

Backup 常见错误与故障排除

"No backups found in ~/openclaw-backups"

备份目录为空或不存在。

1. 确认目录存在：

ls -la ~/openclaw-backups

2. 如果你自定义了路径，检查 OPENCLAW_BACKUP_DIR 是否设置正确：

echo $OPENCLAW_BACKUP_DIR

3. 让 OpenClaw 创建第一个备份："立即备份我的配置。"

"Permission denied when creating backup archive"

备份目录不可写。

# 修复权限
chmod 700 ~/openclaw-backups

# 或创建缺失的目录
mkdir -p ~/openclaw-backups && chmod 700 ~/openclaw-backups

"Backup archive is corrupted — restore failed"

归档在存储或传输过程中损坏。

1. 测试归档完整性：

tar -tzf ~/openclaw-backups/openclaw-2026-03-13_1045.tar.gz > /dev/null

2. 如果已损坏，尝试保留列表中的上一个备份。
3. 对于 Git 同步的备份，检查旧提交中是否有完好的归档：在备份仓库中运行 git log --oneline。