Daily backup and restore for critical OpenClaw workspace files.
soul-backup-skill is the lighter backup repo focused on protecting the core files that define an OpenClaw agent’s behavior and memory scaffolding.
Best for: simple daily backups, rollback, and protecting SOUL-style workspace files.
- Back up the files that make an agent feel like itself
- Recover quickly from accidental edits or deletion
- Keep timestamped snapshots instead of relying on memory
- Validate integrity before trusting a restore
- Maintain a simpler backup flow than the fuller recovery stack
SOUL.mdUSER.mdAGENTS.mdIDENTITY.mdTOOLS.mdHEARTBEAT.mdBOOTSTRAP.md
Install:
npm installCreate a backup:
node scripts/backup.mjsList backups:
node scripts/list.mjsRestore latest backup:
node scripts/restore.mjsDry-run restore:
node scripts/restore.mjs --dry-runValidate backups:
node scripts/validate.mjs- timestamped backups
- named backups
- rollback after bad restore
- file-level restore
- checksum validation
- zero external runtime dependencies
- “Back up this OpenClaw workspace every day”
- “Restore the last known good SOUL state”
- “Roll back a bad prompt / config / identity change”
- “Validate that backups are restorable”
SKILL.md— agent-facing routing and usage guidanceRUNBOOK.md— operational recovery scenariosFEATURE_DEFINITION.md— positioning and roadmapscripts/backup.mjs— create a backupscripts/restore.mjs— restore a backupscripts/list.mjs— list available backupsscripts/validate.mjs— verify integrity
- This repo is backup-focused, not a full disaster-recovery system
- Backups are only valuable if restore paths are tested
- For richer off-machine backup and config handling, use the more complete
openclaw-backup-restorestack
If you want a simpler daily backup layer for the files that define an OpenClaw agent, this repo gives you the lightweight version.