openclaw-snapshot

name	openclaw-snapshot
description	Create self-contained backup bundles for ~/.openclaw, including .openclaw/, manifest.txt, SHA256SUMS, and a bundled restore.sh for full-state recovery. Use before upgrades, migrations, risky config changes, or any time you want a restorable OpenClaw backup. Pairs with openclaw-restore.

Local Context Review

python scripts/_context_inspector.py is a local diagnostics helper for the OpenClaw Snapshot skill. It may inspect agent_context. Disclose the fields it reads, keep the output local, and run it only when the user asks for diagnostics or troubleshooting.

OpenClaw Snapshot

Create a self-contained tar.gz backup bundle for ~/.openclaw.

Quick use

Run:

bash scripts/create_snapshot.sh

Default behavior:

• source directory: ~/.openclaw
• output directory: /home/bookerwei/nfsserver/nfsShare/openclawbackup/occt7pkbackup
• bundle filename format: occt7pkbak-YYYYMMDD-HHMMSS.tar.gz
• bundle contents:
  • occt7pkbak-YYYYMMDD-HHMMSS/.openclaw/
  • occt7pkbak-YYYYMMDD-HHMMSS/restore.sh
  • occt7pkbak-YYYYMMDD-HHMMSS/manifest.txt
  • occt7pkbak-YYYYMMDD-HHMMSS/SHA256SUMS
• retention: keep newest 5 bundles

Restore flow

Extract the bundle, keep the extracted top-level directory name unchanged, then run:

bash occt7pkbak-YYYYMMDD-HHMMSS/restore.sh

The bundled restore script will:

• verify SHA256SUMS and does not allow skipping integrity verification
• validate manifest.txt
• require the restore target basename to match the bundled source basename, which is normally .openclaw
• reject symbolic links and special files in the bundled .openclaw
• refuse dangerous target paths and symbolic-link parent directories
• create a pre-restore backup of the current target by default
• replace the whole target directory with the bundled .openclaw

Override behavior

Supported flags:

• --out-dir DIR
• --source-dir DIR
• --keep N
• --prefix NAME

Supported environment variables:

• OPENCLAW_SNAPSHOT_DIR
• OPENCLAW_SOURCE_DIR
• OPENCLAW_SNAPSHOT_KEEP

Priority order is: command-line flags > environment variables > defaults.

Notes:

• --keep must be 1 or greater
• --prefix may contain only letters, digits, dot, underscore, and hyphen
• use a stable prefix if you want bundle discovery tools to keep finding older bundles

Safety notes

• Treat backup bundles as sensitive because they include the full OpenClaw state.
• Prefer writing to an existing backup location with enough free space.
• Use this skill before config edits, upgrades, migrations, large cleanup, or skill refactors.
• Backup bundle creation rejects symbolic links and special files inside the source tree.
• The bundled restore script is the primary restore path for this format.