OpenClaw Backup 技能安装与使用指南（skill）

一、简介

在AI驱动的生产环境中，数据安全是不可妥协的底线。OpenClaw Backup 作为专为 OpenClaw 设计的 Agent Skill，其核心使命是构建一套可靠的数据保护机制。它能系统性地处理以下关键任务：

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

• 一键全量备份：执行单一命令，完整打包核心配置与业务数据。
• 设置自动备份：配置定时任务，实现备份流程的无人值守自动化。
• 快速恢复数据：在发生问题或需要迁移时，迅速将系统回滚至指定时间点的健康状态。
• 智能版本管理：内置的滚动策略默认保留最近的7份备份，在保障可恢复性的同时，智能管理存储开销。

二、安装

方法1：通过 Clawhub 安装（推荐）

通过官方技能仓库安装是获取最新稳定版本的标准方式。执行以下命令行指令：

openclaw skills search backup
openclaw skills add openclaw-backup

方法2：手动克隆到本地

如需使用特定分支或进行二次开发，可直接从 GitHub 仓库克隆源代码至本地技能目录。

cd ~/.openclaw/workspace/skills/
git clone https://github.com/openclaw/openclaw-backup.git

验证安装

安装完成后，通过验证核心脚本文件的存在以确认安装成功：

ls ~/.openclaw/workspace/skills/openclaw-backup/scripts/backup.sh

若命令返回该文件的完整路径，则说明 OpenClaw Backup 技能已就绪。

三、使用方法

1. 创建手动备份

手动备份是基础操作。其本质是调用并执行备份脚本。

基本用法：

bash ~/.openclaw/workspace/skills/openclaw-backup/scripts/backup.sh

指定备份目录：
可通过参数将备份文件输出到自定义目录。

bash ~/.openclaw/workspace/skills/openclaw-backup/scripts/backup.sh /path/to/backup/dir

命令执行成功后，终端将输出备份文件的详细信息，包括路径、大小及当前备份集总数：

✅ Backup created: /home/zilong/openclaw-backups/openclaw-2026-03-19_1611.tar.gz (8.8M)
???? Total backups: 1

2. 备份内容说明

理解备份包的目录结构，对后续的灾难恢复和配置审计至关重要。以下是打包的核心内容：

为优化备份效率与体积，以下非必要数据已被排除：

• completions/ - API响应缓存。此部分可丢弃，后续请求会自动重新生成。
• *.log - 各类日志文件。仅用于运行时调试，不纳入版本化管理。

3. 设置自动定时备份

通过 OpenClaw 的 Cron 系统配置自动化备份，是符合运维最佳实践的做法。例如，创建一份每日凌晨执行的备份任务：

openclaw cron add

在交互提示中，填入如下格式的JSON配置：

{
  "name": "daily-backup",
  "schedule": {"kind": "cron", "expr": "0 3 * * *", "tz": "Asia/Shanghai"},
  "payload": {
    "kind": "agentTurn",
    "message": "Run ~/.openclaw/workspace/skills/openclaw-backup/scripts/backup.sh and report result to user."
  },
  "sessionTarget": "isolated",
  "delivery": {"mode": "announce"}
}

此配置将在北京时间每日03:00自动触发备份任务，执行完毕后向用户推送通知结果，实现静默守护。

4. 恢复备份

恢复操作是检验备份有效性的最终环节。请严格按顺序执行以下步骤，特别是在生产环境：

# 1. 停止 OpenClaw 服务，防止数据写入冲突
openclaw gateway stop

# 2. 为当前数据创建一份临时备份，作为安全回滚点
mv ~/.openclaw ~/.openclaw-old

# 3. 将指定备份包解压至用户主目录
cd ~
tar -xzf ~/openclaw-backups/openclaw-2026-03-19_1611.tar.gz

# 4. 重启 OpenClaw 服务
openclaw gateway start

# 5. 验证服务状态与核心功能
openclaw status

若恢复后出现异常，可按以下流程回退至先前状态：

# 移除恢复出现问题的目录
rm -rf ~/.openclaw

# 将之前备份的旧数据目录恢复原位
mv ~/.openclaw-old ~/.openclaw

# 重新启动服务
openclaw gateway start

四、备份管理

查看备份列表

使用标准 Shell 命令快速查看现有备份文件列表及其详细信息：

ls -lh ~/openclaw-backups/openclaw-*.tar.gz

清理旧备份

脚本默认启用滚动清理策略，仅保留最近7份备份。如需自定义保留数量（例如仅保留3份），可手动执行清理：

# 进入备份目录，按时间倒序排列文件，删除第4个之后的所有历史备份
cd ~/openclaw-backups
ls -t openclaw-*.tar.gz | tail -n +4 | xargs rm

五、最佳实践

遵循以下行业准则，可进一步提升数据保护策略的鲁棒性：

1. 初始化后立即备份：完成OpenClaw基础配置、添加关键频道后，应立即创建初始全量备份。
2. 变更前先备份：在执行任何重大变更（如版本升级、核心参数调整）前，手动创建一次临时备份。
3. 实施异地备份：定期将备份文件同步至对象存储或离线介质，防范单点物理故障。
4. 定期演练恢复：在测试环境中周期性地执行恢复流程演练，确保备份文件的完整性与恢复步骤的可靠性。

六、常见问题

Q: 备份文件可以跨机器使用吗？
A: 可以。备份文件具备环境可移植性。在已安装同版本 OpenClaw 的新机器上执行恢复，即可完整复制所有配置与数据。

Q: 备份包含 API 密钥吗？
A: 包含。备份会完整打包 credentials/ 目录下的所有鉴权信息。因此，必须对备份文件本身实施严格的访问控制与加密存储。

Q: 如何迁移到另一台机器？
A: 流程清晰：在新主机完成 OpenClaw 基础部署后，直接使用备份文件执行上述恢复操作，即可实现环境迁移。

Q: 备份文件太大怎么办？
A: 标准配置备份体积通常较小（5-20MB）。若体积异常，请首先确认是否已正确排除 completions/ API缓存目录。

七、参考链接

• OpenClaw 官方文档：https://docs.openclaw.ai
• 本技能源码仓库：https://github.com/openclaw/openclaw-backup
• OpenClaw 备份技能详细说明文档：~/.openclaw/workspace/skills/openclaw-backup/SKILL.md

行动指导：理论的价值在于实践。建议你现在就运行一次备份命令，亲眼确认备份文件的生成，这是构建可靠AI工作流的第一步。

bash ~/.openclaw/workspace/skills/openclaw-backup/scripts/backup.sh