ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

simple-backup

Backup agent brain (workspace) and body (state) to local folder and optionally sync to cloud via rclone.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/vacinc/simple-backup
Or

Simple Backup

A robust backup script that:

  1. Auto-detects workspace and state directories from OpenClaw config
  2. Allows overrides for custom/non-standard setups
  3. Compresses & encrypts using GPG (AES256)
  4. Prunes old backups (Daily/Hourly retention)
  5. Syncs to cloud via rclone (optional)

Setup

  1. Dependencies:

    brew install rclone gnupg jq
    
  2. Password: Set encryption password (choose one):

    • File: ~/.openclaw/credentials/backup.key (recommended)
    • Env: export BACKUP_PASSWORD="secret"
    • Config: Add "password": "secret" to skill config
  3. Cloud (Optional):

    rclone config
    

Usage

simple-backup

Auto-Detection

By default, paths are auto-detected from ~/.openclaw/openclaw.json:

  • Workspace: agents.defaults.workspace
  • State: ~/.openclaw (where config lives)
  • Backup root: <workspace>/BACKUPS

Custom Configuration

For non-standard setups, override any path in ~/.openclaw/openclaw.json:

{
  "skills": {
    "entries": {
      "simple-backup": {
        "config": {
          "workspaceDir": "/custom/path/workspace",
          "stateDir": "/custom/path/state",
          "skillsDir": "/custom/path/skills",
          "backupRoot": "/custom/path/backups",
          "remoteDest": "gdrive:backups"
        }
      }
    }
  }
}

Configuration Reference

Config KeyEnv VarAuto-DetectedDescription
workspaceDirBRAIN_DIRagents.defaults.workspaceAgent workspace
stateDirBODY_DIR~/.openclawOpenClaw state dir
skillsDirSKILLS_DIR~/openclaw/skillsSkills directory
backupRootBACKUP_ROOT<workspace>/BACKUPSLocal backup storage
remoteDestREMOTE_DEST(none)Rclone remote path
maxDaysMAX_DAYS7Days to keep daily backups
hourlyRetentionHoursHOURLY_RETENTION_HOURS24Hours to keep hourly
passwordBACKUP_PASSWORD(none)Encryption password

Priority: Config file → Env var → Auto-detect

Metadata

Author@vacinc
Stars946
Views1
Updated2026-02-13
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-vacinc-simple-backup": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.