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

一、简介

OpenClaw Backup 是一个用于备份和恢复 OpenClaw 数据的 Agent Skill。它可以帮助你：

一键备份 OpenClaw 的所有配置和数据
设置自动定时备份
在需要时快速恢复数据
自动管理备份版本（保留最近7个）

二、安装

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

bash 复制代码

openclaw skills search backup
openclaw skills add openclaw-backup

方法2：手动克隆到本地

bash 复制代码

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

验证安装

bash 复制代码

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

三、使用方法

1. 创建手动备份

基本用法：

bash 复制代码

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

指定备份目录：

bash 复制代码

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. 备份内容说明

目录/文件	说明
`openclaw.json`	主配置文件（含频道、模型配置）
`credentials/`	API 密钥、Token 等敏感信息
`agents/`	Agent 配置、认证配置
`workspace/`	Memory、SOUL.md、用户文件
`cron/`	定时任务配置

排除项（不备份）：

completions/ - API 响应缓存（可自动重建）
*.log - 日志文件

3. 设置自动定时备份

使用 OpenClaw Cron 设置每日自动备份：

bash 复制代码

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"}
}

以上配置表示：每天凌晨 3 点（北京时间）自动执行备份，并通知用户结果。

4. 恢复备份

快速恢复步骤：

bash 复制代码

# 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

恢复失败回滚：

bash 复制代码

rm -rf ~/.openclaw
mv ~/.openclaw-old ~/.openclaw
openclaw gateway start

四、备份管理

查看备份列表

bash 复制代码

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

清理旧备份

脚本默认保留最近 7 个 备份，旧备份会自动删除。

如需手动清理：

bash 复制代码

# 保留最近 3 个，删除其余的
cd ~/openclaw-backups
ls -t openclaw-*.tar.gz | tail -n +4 | xargs rm

五、最佳实践

首次使用后立即备份 - 配置好频道、模型后立即创建第一个备份
重大变更前备份 - 升级版本、修改配置前先备份
异地备份 - 定期将备份文件复制到云盘或外部存储
测试恢复 - 定期验证备份文件可以正常恢复

六、常见问题

Q: 备份文件可以跨机器使用吗？

A: 可以。只要目标机器安装了相同版本的 OpenClaw，备份文件可以直接恢复使用。

Q: 备份包含 API 密钥吗？

A: 包含。备份文件中有 credentials/ 目录，存储了你的 API Key 和 Token。请妥善保管备份文件。

Q: 如何迁移到另一台机器？

A: 在新机器上安装 OpenClaw，然后使用上述恢复步骤即可完整迁移所有配置和数据。

Q: 备份文件太大怎么办？

A: 检查 completions/ 目录是否被正确排除。正常备份大小通常在 5-20MB 之间。

七、参考链接

OpenClaw 官方文档：https://docs.openclaw.ai
技能源码：https://github.com/openclaw/openclaw-backup
OpenClaw 备份技能 SKILL.md：~/.openclaw/workspace/skills/openclaw-backup/SKILL.md

提示： 建议现在就执行一次备份，确保你的配置安全！

bash 复制代码

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