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

一、简介

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

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

二、安装

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

openclaw skills search backup openclaw skillsaddopenclaw-backup

方法2：手动克隆到本地

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

验证安装

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

三、使用方法

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 设置每日自动备份：

openclawcronadd

按提示填写：

{"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. 恢复备份

快速恢复步骤：

# 1. 停止 OpenClawopenclaw gateway stop# 2. 备份当前数据（安全起见）mv~/.openclaw ~/.openclaw-old# 3. 解压备份文件cd~tar-xzf~/openclaw-backups/openclaw-2026-03-19_1611.tar.gz# 4. 启动 OpenClawopenclaw gateway start# 5. 验证状态openclaw status

恢复失败回滚：

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

四、备份管理

查看备份列表

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

清理旧备份

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

如需手动清理：

# 保留最近 3 个，删除其余的cd~/openclaw-backupsls-topenclaw-*.tar.gz|tail-n+4|xargsrm

五、最佳实践

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

六、常见问题

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~/.openclaw/workspace/skills/openclaw-backup/scripts/backup.sh