openclaw-state-backup
Create, inspect, and restore versioned OpenClaw state backups with rollback safety. Use when backing up or migrating OpenClaw memory, workspace state, gateway config, cron/session state, or when restoring a previously captured snapshot after breakage, config mistakes, host migration, or context-loss concerns.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/danielwangyy/openclaw-state-backupOpenClaw State Backup
Create and restore versioned, restorable snapshots of mutable OpenClaw state.
What changes over time
Treat these as mutable state and include them in backups when they exist:
~/.openclaw/openclaw.json— runtime config~/.openclaw/sessions.json— session metadata~/.openclaw/restart-sentinel.json— recent restart delivery state~/.openclaw/memory/— vector index / memory DBs~/.openclaw/agents/— per-agent runtime/session stateworkspace/MEMORY.mdworkspace/memory/workspace/SESSION-STATE.mdworkspace/HEARTBEAT.mdworkspace/TOOLS.mdworkspace/skills/— user-authored skills and local skill state
Treat these as mostly static/user-maintained bootstrap files and back them up when you want a full environment restore, but do not rely on them as fast-changing runtime state:
workspace/SOUL.mdworkspace/USER.mdworkspace/IDENTITY.mdworkspace/AGENTS.mdworkspace/BOOTSTRAP.md(if still present)
Backup strategy
Use the bundled scripts for deterministic behavior.
Create backup
Run scripts/backup_state.py with:
--workspace <path>--state-dir <path>(usually~/.openclaw)--output-dir <path>for generated snapshots- optional
--label <name> - optional
--mode mutable|full(default:mutable) - optional repeated
--include-prefix <relative-path-prefix> - optional repeated
--exclude-prefix <relative-path-prefix>
mutable captures changing state only.
full adds mostly-static workspace identity/bootstrap files too.
The script writes:
- a timestamped
.tar.gz - a
manifest.json - checksums for every stored file
- compatibility metadata (
formatVersion, OpenClaw version, host/platform) - applied include/exclude filter metadata
Restore backup
Run scripts/restore_state.py with:
--archive <path-to-tar.gz>--workspace <path>--state-dir <path>- optional
--verify-only - optional
--dry-run - optional
--allow-version-mismatch - optional
--report-dir <path> - optional repeated
--include-prefix <relative-path-prefix> - optional repeated
--exclude-prefix <relative-path-prefix>
Restore behavior:
- verify archive structure + checksums
- compare compatibility metadata
- optionally narrow restore scope with include/exclude prefixes
- build a restore plan (
create/update/unchanged/missingFromArchive) - always write a JSON restore/dry-run report to disk
- if
--dry-run, stop after writing the diff-style report - otherwise create a pre-restore rollback backup automatically
- restore files into place
- write a final restore report showing what changed and where rollback lives
Safety rules
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-danielwangyy-openclaw-state-backup": {
"enabled": true,
"auto_update": true
}
}
}Related Skills
sentiment-radar
Multi-platform sentiment monitoring and analysis for products/brands/topics. Collect public opinions from Chinese platforms (小红书/XHS via MediaCrawler) and English platforms (Twitter/Reddit via Xpoz MCP). Generate structured sentiment reports with product mention tracking, pricing complaints, comparison analysis, and actionable insights. Use when: (1) monitoring competitor sentiment, (2) tracking product launch reception, (3) analyzing user pain points across social media, (4) building market intelligence reports.
jd-price-protect
Auto-apply JD.com (京东) price protection on all eligible orders. Connects to Chrome via OpenClaw Browser Relay CDP, navigates to JD price protection page, clicks all "申请价保" buttons, and reports refund results. Supports pagination and scheduled cron usage.