Simple Backup

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

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 Key	Env Var	Auto-Detected	Description
workspaceDir	BRAIN_DIR	agents.defaults.workspace	Agent workspace
stateDir	BODY_DIR	~/.openclaw	OpenClaw state dir
skillsDir	SKILLS_DIR	~/openclaw/skills	Skills directory
backupRoot	BACKUP_ROOT	<workspace>/BACKUPS	Local backup storage
remoteDest	REMOTE_DEST	(none)	Rclone remote path
maxDays	MAX_DAYS	7	Days to keep daily backups
hourlyRetentionHours	HOURLY_RETENTION_HOURS	24	Hours to keep hourly
password	BACKUP_PASSWORD	(none)	Encryption password

Priority: Config file → Env var → Auto-detect