openclaw-backup-guard
v2.1.2
Published
Auto backup, one-click restore & gateway watchdog for OpenClaw. Dual-backup rotation, scheduled auto-backup, auto-restart on crash. Windows & Linux.
Maintainers
Readme
openclaw-backup-guard
Auto backup, one-click restore & gateway watchdog for OpenClaw. Works on Windows and Linux.
Features
- Dual backup rotation - Always keeps 2 backups (new + old), one fails use the other
- Scheduled auto-backup - Windows Scheduled Task or Linux cron
- One-click restore - Stop service, restore config, reinstall deps, restart gateway
- Gateway watchdog - Auto-detect crash & restart gateway within minutes
- Cross-platform - Pure Node.js, no native dependencies
- Lightweight - Backs up config & data only (~10MB), skips
node_modules
Install
openclaw plugins install openclaw-backup-guardQuick Start
One-click full setup (backup every 4h + watchdog every 5min)
node ~/.openclaw/extensions/openclaw-backup-guard/scripts/setup-guard.mjs 4Custom watchdog interval (e.g. check every 3 minutes):
node ~/.openclaw/extensions/openclaw-backup-guard/scripts/setup-guard.mjs 4 --watchdog 3Manual backup
node ~/.openclaw/extensions/openclaw-backup-guard/scripts/backup.mjsRestore
# Interactive (select backup)
node ~/.openclaw/extensions/openclaw-backup-guard/scripts/restore.mjs
# Direct restore from latest backup
node ~/.openclaw/extensions/openclaw-backup-guard/scripts/restore.mjs new
# Direct restore from previous backup
node ~/.openclaw/extensions/openclaw-backup-guard/scripts/restore.mjs oldCheck gateway status
node ~/.openclaw/extensions/openclaw-backup-guard/scripts/watchdog.mjsRun watchdog as foreground daemon
node ~/.openclaw/extensions/openclaw-backup-guard/scripts/watchdog.mjs --daemon --interval 300Windows desktop shortcuts
node ~/.openclaw/extensions/openclaw-backup-guard/scripts/install-shortcuts.mjsRemove all guards
node ~/.openclaw/extensions/openclaw-backup-guard/scripts/setup-guard.mjs --removeHow it works
Before backup: After backup:
backup-new (4h ago) backup-new (just created)
backup-old (8h ago) backup-old (was backup-new)Each backup saves:
openclaw.json+.bak(config)gateway.cmd/gateway.sh(startup script)agents/(agent sessions & data)credentials/,skills/,memory/,workspace/,cron/extensions/(plugin source, excludingnode_modules)
Restore flow
- Stop all OpenClaw processes
- Restore all config and data files
- Reinstall plugin
node_modulesif missing - Start Gateway in background
Environment
| Variable | Default | Description |
|----------|---------|-------------|
| OPENCLAW_BACKUP_DIR | ~/openclaw-backups | Custom backup directory |
License
MIT
