Self Backup & Restore

Backup and restore your OpenClaw agent's complete state, including: configuration, skills, memory, and workspace files.

What Gets Backed Up

What's NOT Backed Up

• ~/.openclaw/logs/ — logs, not needed
• ~/.openclaw/media/ — media cache, too large
• ~/.openclaw/workspace/.venv-*/ — Python envs, can be rebuilt
• ~/.openclaw/completions/ — history cache

Run Backup

python3 ~/.openclaw/workspace/skills/self-backup/scripts/backup.py

Output: ~/backups/openclaw-backup-YYYY-MM-DD_HHMM.tar.gz

Run Restore

python3 ~/.openclaw/workspace/skills/self-backup/scripts/restore.py ~/backups/openclaw-backup-YYYY-MM-DD_HHMM.tar.gz

List Backups

python3 ~/.openclaw/workspace/skills/self-backup/scripts/backup.py --list

Setup Weekly Auto-Backup (via OpenClaw cron)

openclaw cron add \
  --name "weekly-self-backup" \
  --cron "0 2 * * 0" \
  --tz "Asia/Shanghai" \
  --message "Run backup: python3 ~/.openclaw/workspace/skills/self-backup/scripts/backup.py and report result" \
  --session isolated \
  --announce \
  --channel telegram

After Restore: Rebuild Steps

1. Reinstall OpenClaw (fresh machine only)

```bash

npm install -g openclaw

```

1. Restore backup

```bash

python3 restore.py openclaw-backup-YYYY-MM-DD.tar.gz

```

1. Rebuild Python environment (not included in backup)

```bash

cd ~/.openclaw/workspace

python3 -m venv .venv-stock

source .venv-stock/bin/activate

pip install yfinance pandas numpy pandas-ta ta ddgs tavily-python requests beautifulsoup4

```

1. Re-login ClawHub

```bash

clawhub auth login --token --no-browser

```

1. Verify

```bash

openclaw status && openclaw doctor

```