OpenSkillIndex← back to search
claude-code

Skills 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.

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/benxiao2026/agent-state-backup" ~/.claude/skills/clawdbot-skills-agent-state-backup && rm -rf "$T"
manifest: skills/benxiao2026/agent-state-backup/SKILL.md
source content

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