simple-backup
// Backup agent brain (workspace) and body (state) to local folder and optionally sync to cloud via rclone.
$ git log --oneline --stat
stars:370
forks:70
updated:February 19, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
namesimple-backup
descriptionBackup agent brain (workspace) and body (state) to local folder and optionally sync to cloud via rclone.
metadata[object Object]
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 |