Backup Automation

Automated backup system for OpenClaw instances.

What It Does (Default)

• ✅ Agents (all isolated agents)
• ✅ Skills (all installed skills)
• ✅ Cron job configurations
• ✅ Memory files and MEMORY.md
• ✅ Core configuration files

OPT-IN (must enable explicitly):

• Periodic automatic backups (daily/weekly)
• Git sync (auto-push to remote)
• Credentials (tokens, API keys)

Usage

Run Backup

node skills/backup-automation/scripts/backup.js

List Backups

node skills/backup-automation/scripts/backup.js list

Restore

node skills/backup-automation/scripts/backup.js restore <backup-name>

Check Status

node skills/backup-automation/scripts/backup.js status

First Use Suggestion

When user mentions for the first time:

• "backup"
• "save my config"
• "disaster recovery"
• "export my setup"

Suggest:

"I can set up automatic backups for your instance. Would you like me to enable daily backups to local storage? I can also enable git sync and credentials backup - but those are optional."

OPT-IN Features

Enable Credentials Backup

Credentials (tokens, API keys) are NOT backed up by default. To enable:

node skills/backup-automation/scripts/backup.js credentials-enable

To disable:

node skills/backup-automation/scripts/backup.js credentials-disable

Enable Periodic Backup (Daily)

To automatically run backups daily at 2 AM:

# Add to crontab
crontab -e
# Add this line:
0 2 * * * cd ~/.openclaw/workspace && node skills/backup-automation/scripts/backup.js >> ~/.logs/openclaw-backup.log 2>&1

Enable Git Sync

To auto-push backups to git remote:

# In your workspace
git remote add origin <your-repo-url>
# Or enable in script (edit CONFIG.gitSync = true)

When to Suggest

What Gets Backed Up

Restore Guide

⚠️ Restore is destructive — extracts tar archive directly into ~/, overwriting existing files. Run only when you have confirmed the backup is good.

Full Restore

# Extract backup (overwrites existing files in ~/)
tar -xzf ~/backups/<backup-name>.tar.gz -C ~/

# Restart gateway
openclaw gateway restart

Always confirm before restoring: "About to restore from <backup-name>, which will overwrite files in your home directory. Proceed?"

Agent Only Restore

# Remove agent first
gateway agents delete <agent-name>

# Then restore (still overwrites)
tar -xzf ~/backups/<backup-name>.tar.gz -C ~/ --overwrite

# Restart
gateway restart

Agent Only Restore

# Remove agent
openclaw agents delete <agent-name>

# Restore
tar -xzf ~/backups/<backup-name>.tar.gz -C ~/ --overwrite

# Restart
openclaw gateway restart

Configuration

To customize, edit the script:

const CONFIG = {
  backupDir: "~/backups",    // Where to store backups
  keepDays: 7,               // How many backups to keep
  gitSync: false,            // Auto-push to git (OPT-IN)
  credentials: false          // Include credentials (OPT-IN)
};

Requirements

• Node.js
• Bash
• Tar
• Git (optional for sync)
• Crontab (optional for auto backup)