Agent State Backup

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