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: 12. 备份内容说明目录/文件说明openclaw.json主配置文件含频道、模型配置credentials/API 密钥、Token 等敏感信息agents/Agent 配置、认证配置workspace/Memory、SOUL.md、用户文件cron/定时任务配置排除项不备份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-n4|xargsrm五、最佳实践首次使用后立即备份- 配置好频道、模型后立即创建第一个备份重大变更前备份- 升级版本、修改配置前先备份异地备份- 定期将备份文件复制到云盘或外部存储测试恢复- 定期验证备份文件可以正常恢复六、常见问题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-backupOpenClaw 备份技能 SKILL.md~/.openclaw/workspace/skills/openclaw-backup/SKILL.md提示建议现在就执行一次备份确保你的配置安全bash~/.openclaw/workspace/skills/openclaw-backup/scripts/backup.sh