ClawBackup

Claw Backup

Version: 1.0.15

Back up your OpenClaw customizations (memory, config, skills, workspace) to an rclone destination on a schedule (Google Drive by default). Works on macOS, Linux, and Windows (via Git Bash or WSL).

What it does

• Backs up clawd memory, ~/.openclaw (config, skills, modules, workspace, cron), clawd/scripts, and Dev/CursorApps/clawd (excluding node_modules)
• Runs on a schedule (macOS LaunchAgent, Linux cron, or Windows Task Scheduler)
• Applies local and remote retention so old backups are pruned
• Supports rclone (cloud) or local-only upload mode

Restore notes

Each archive includes RESTORE_NOTES.txt with the correct restore targets based on the configured paths. In general:

• openclaw_config/skills → ~/.openclaw/skills
• cursorapps_clawd/skills → ~/Dev/CursorApps/clawd/skills (or your chosen path)

Quick start

1. Prerequisites: Node.js, rclone configured for Google Drive, and Bash (or Git Bash on Windows).

   • rclone is only required when upload mode is rclone.

2. Recommended install (review first):

   git clone https://github.com/vidarbrekke/ClawBackup.git
   cd ClawBackup
   node setup.js
   

3. Quick install (advanced users):

   curl -fsSL https://raw.githubusercontent.com/vidarbrekke/ClawBackup/main/setup.js | node
   

4. Follow the prompts (or use node setup.js --defaults for default paths). Then run the printed test command and install the scheduler as shown.

Security notes

• Backups may contain sensitive data (OpenClaw config, memory, and skills).
• Setup can install recurring scheduler entries (LaunchAgent/cron/Task Scheduler).
• In cloud mode, credentials come from your existing rclone config; no extra env vars are required by this repo.
• Prefer encrypted destinations (e.g. rclone crypt) or encrypt archives before offsite storage.
• Archives include checksum files (.sha256) for integrity checks.

Repo and contributions

• Code and full docs: github.com/vidarbrekke/ClawBackup
• Improvements welcome: Open issues or pull requests on the GitHub repo. The project is open for refinements, fixes, and features from any OpenClaw user.

License

MIT