OpenClaw Backup (Optimized)

---

name: openclaw-backup-optimized

description: "Optimized OpenClaw backup skill for creating full snapshots with workspace archive splitting, change summaries, restore instructions, and Discord notifications. Use when you need to set up or run automated backups, configure backup cron jobs, or document/restore OpenClaw state. Triggers on backup automation, backup scripts, snapshot/restore, or GitHub backup repos."

---

# OpenClaw Backup (Optimized)

What this skill does

Use this skill to **install, configure, and run** the optimized OpenClaw backup workflow:

Files

Install / Setup

1) Copy the script into your tools folder:

cp scripts/backup.js ~/.openclaw/workspace/tools/openclaw-backup.js

2) Configure env vars (see references/CONFIG.md):

**macOS/Linux (bash/zsh):**

export OPENCLAW_HOME="$HOME/.openclaw"
export OPENCLAW_BACKUP_DIR="$HOME/.openclaw-backup"
export BACKUP_REPO_URL="https://github.com/your/repo.git"
export BACKUP_CHANNEL_ID="1234567890"
export BACKUP_TZ="America/Sao_Paulo"
export BACKUP_MAX_HISTORY=7

**Windows (PowerShell):**

$env:OPENCLAW_HOME="$env:USERPROFILE\.openclaw"
$env:OPENCLAW_BACKUP_DIR="$env:USERPROFILE\.openclaw-backup"
$env:BACKUP_REPO_URL="https://github.com/your/repo.git"
$env:BACKUP_CHANNEL_ID="1234567890"
$env:BACKUP_TZ="America/Sao_Paulo"
$env:BACKUP_MAX_HISTORY="7"

3) Run once:

node ~/.openclaw/workspace/tools/openclaw-backup.js

4) Create cron (OpenClaw cron runs in the gateway environment):

openclaw cron add --name "openclaw-backup-daily" \
  --cron "0 5,10,15,20 * * *" --tz "America/Sao_Paulo" \
  --exec "node ~/.openclaw/workspace/tools/openclaw-backup.js"

Restore

Use the restore instructions printed in the backup notification.

Notes