simple-backup

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

⭐3stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

This Claude skill provides a robust and automated solution for backing up an AI agent's 'brain' (workspace) and 'body' (state). It streamlines the process of staging, compressing, and encrypting sensitive data using AES256 GPG encryption. Designed for reliability, it includes automated pruning for retention management and supports seamless cloud synchronization via rclone, ensuring your agentic workflows are resilient, secure, and easily recoverable.

Use Cases

  • Disaster Recovery: Protect against data loss by creating encrypted, compressed backups of agent states and workspaces to local or cloud storage.
  • Environment Migration: Securely transfer an agent's configuration and memory between different servers or local environments using standardized .tgz archives.
  • Automated Retention Management: Maintain a clean storage footprint with configurable daily and hourly backup rotation policies to prevent disk overflow.
  • Multi-Cloud Redundancy: Leverage rclone integration to automatically sync agent backups to providers like Google Drive, AWS S3, or Dropbox for high availability.
namesimple-backup
descriptionBackup agent brain (workspace) and body (state) to local folder and optionally sync to cloud via rclone.
metadata{"clawdbot":{"emoji":"💾","requires":{"bins":["rclone","gpg","tar"]}}}

Simple Backup

A robust backup script that:

  1. Stages: Copies ~/clawd (workspace), ~/.clawdbot (state), and skills/.
  2. Compresses: Creates a .tgz archive.
  3. Encrypts: AES256 encryption using GPG (password required).
  4. Prunes: Rotates backups (Daily/Hourly retention).
  5. Syncs: Optionally pushes to a cloud provider via rclone.

Setup

  1. Dependencies: Ensure rclone and gpg are installed (brew install rclone gnupg).
  2. Password: Set the encryption password:
    • Env Var: export BACKUP_PASSWORD="my-secret-password"
    • File: ~/.clawdbot/credentials/backup.key
  3. Cloud (Optional): Configure an rclone remote:
    rclone config
    

Usage

Run the backup:

simple-backup

Configuration

You can override defaults with environment variables:

Variable Default Description
BACKUP_ROOT ~/clawd/BACKUPS Local storage location
REMOTE_DEST (empty) Rclone path (e.g. gdrive:backups)
MAX_DAYS 7 Days to keep daily backups
HOURLY_RETENTION_HOURS 24 Hours to keep hourly backups