Agent State Backup

---

name: agent-state-backup description: Auto-backs up core files (IDENTITY, SOUL, MEMORY, knowledge base) daily via cron, creates compressed .tgz archive, enables one-click restore in new environment. Solves context loss after restart/migration.

---

Agent State Backup & Restore

自动备份 OpenClaw 核心状态文件，防止上下文丢失。

📦 备份内容

IDENTITY.md - 身份定义

SOUL.md - 人格定义

MEMORY.md - 长期记忆

memory/*.md - 每日记忆

USER.md - 用户信息

knowledge/**/* - 知识库

🚀 快速使用

手动备份

~/.openclaw/workspace/scripts/agent-backup.sh

手动恢复

~/.openclaw/workspace/scripts/agent-restore.sh

设置自动备份 (每日凌晨 2 点)

~/.openclaw/workspace/scripts/setup-backup-cron.sh

📁 文件位置

备份脚本: ~/.openclaw/workspace/scripts/agent-backup.sh

恢复脚本: ~/.openclaw/workspace/scripts/agent-restore.sh

备份目录: ~/.openclaw/backups/

保留策略: 最近 7 个备份

🔧 配置选项

编辑 ~/.openclaw/workspace/scripts/agent-backup.sh:

# 修改保留天数 (默认 7 天)
ls -t agent_backup_*.tgz | tail -n +8 | xargs -r rm
改为保留 30 天：tail -n +31
修改备份目录
BACKUP_DIR="$HOME/.openclaw/backups"

📊 备份日志

查看备份历史:

cat ~/.openclaw/backups/backup.log

⚠️ 注意事项

1. 首次备份前 - 确保所有重要文件已保存 2. 恢复操作 - 会覆盖当前文件，建议先备份当前状态 3. 磁盘空间 - 每个备份约 20-50KB，7 个备份约 350KB 4. Cron 权限 - 确保 cron 有权限访问工作目录

🔄 迁移到新环境

1. 在新环境安装 OpenClaw 2. 复制备份文件 .tgz 到新机器 3. 运行 agent-restore.sh 4. 重启 OpenClaw

---

版本: 1.0.0 最后更新: 2026-03-03 依赖: bash, tar, gzip