ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

openclaw-backup-optimized

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.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/cccarv82/openclaw-backup-optimized
Or

OpenClaw Backup (Optimized)

What this skill does

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

  • Full snapshot of ~/.openclaw
  • Workspace archive split into ~90MB parts + SHA256
  • Rich Discord notification (summary + restore steps)
  • Retention of last N reports

Files

  • Script: scripts/backup.js (cross-platform)
  • Reference config: references/CONFIG.md

Install / Setup

  1. Copy the script into your tools folder:
cp scripts/backup.js ~/.openclaw/workspace/tools/openclaw-backup.js
  1. 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"
  1. Run once:
node ~/.openclaw/workspace/tools/openclaw-backup.js
  1. 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

  • Excludes noisy session lock/deleted files for smaller diffs.
  • Requires git and node (>=18).
  • Uses openclaw message send for notifications (no webhook).
  • scripts/openclaw-backup.sh is legacy (Linux/macOS) and will be removed; use backup.js.
Read Full Documentation on GitHub

Metadata

Author@cccarv82
Stars4044
Views1
Updated2026-04-12
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-cccarv82-openclaw-backup-optimized": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.