simple-backup
Backup agent brain (workspace) and body (state) to local folder and optionally sync to cloud via rclone.
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.
| name | simple-backup |
|---|---|
| description | Backup 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:
- Stages: Copies
~/clawd(workspace),~/.clawdbot(state), andskills/. - Compresses: Creates a
.tgzarchive. - Encrypts: AES256 encryption using GPG (password required).
- Prunes: Rotates backups (Daily/Hourly retention).
- Syncs: Optionally pushes to a cloud provider via
rclone.
Setup
- Dependencies: Ensure
rcloneandgpgare installed (brew install rclone gnupg). - Password: Set the encryption password:
- Env Var:
export BACKUP_PASSWORD="my-secret-password" - File:
~/.clawdbot/credentials/backup.key
- Env Var:
- 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 |