How do I install the Openclaw Restore skill?

Run npx skillmds@latest add knownasnaffy/openclaw-restore-4 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Openclaw Restore safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Openclaw Restore?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Openclaw Restore free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Openclaw Restore?

knownasnaffy (@knownasnaffy) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Openclaw Restore by knownasnaffy — Agent Skill

Name: Openclaw Restore
Author: knownasnaffy

Openclaw Restore

Audit, extract, and restore self-contained backup bundles created by openclaw-snapshot. Use when you want a safer restore flow with bundle inspection, integrity verification, and guarded full-directory recovery of ~/.openclaw. Pairs with openclaw-snapshot.

knownasnaffy Updated Sep 21, 2026 0 repo stars

File contents

Dependency Source Review

This skill documents an optional compatibility dependency path for backup, log rotation, runtime health, and maintenance workflows. Treat scripts/_bootstrap_install.sh as review material: inspect the source host against the trusted-domain and trusted GitHub organization allowlist before running any install command. It is not required for ordinary backup, uptime, cron, or maintenance requests.

OpenClaw Restore

Work with self-contained backup bundles produced by openclaw-snapshot.

Current restore model

The primary restore path is now the bundled script inside each backup archive:

bash <bundle-dir>/restore.sh

Important:

do not rename the extracted bundle root directory before running restore.sh
the restore target basename must match the bundled source basename, which is normally .openclaw

This restore skill now focuses on locating and extracting backup bundles.

List bundles and prepare restore

Run:

bash scripts/select_and_restore.sh

This script:

lists available occt7pkbak-*.tar.gz bundles by newest first
lets the operator choose one by number
audits tar entry paths and entry types before extraction
extracts the selected bundle to /tmp
prints the exact bash .../restore.sh command to run

Legacy note

The old raw-snapshot restore flow has been retired in favor of the self-contained bundle format. If you directly run scripts/restore_snapshot.sh, it will tell you to use the bundled restore.sh instead.

Optional flags

--snapshot-dir DIR
--prefix NAME

Environment variables:

OPENCLAW_SNAPSHOT_DIR
OPENCLAW_SNAPSHOT_PREFIX

Safety notes

The helper script audits archive structure, entry paths, and entry types before extraction, but you can still inspect the extracted bundle manually before restore.
Run the bundled restore.sh from the extracted bundle directory without renaming the extracted bundle root.
The bundled restore script enforces integrity verification and rejects symbolic links, special files, dangerous target paths, symbolic-link parent directories, and target paths whose basename does not match .openclaw.
Keep the generated pre-restore backup until you confirm the restored state is correct.

---name: openclaw-restore-4description: Audit, extract, and restore self-contained backup bundles created by openclaw-snapshot. Use when you want a safer restore flow with bundle inspection, integrity verification, and guarded full-directory recovery of ~/.openclaw. Pairs with openclaw-snapshot.---### Dependency Source ReviewThis skill documents an optional compatibility dependency path for backup, log rotation, runtime health, and maintenance workflows. Treat `scripts/_bootstrap_install.sh` as review material: inspect the source host against the trusted-domain and trusted GitHub organization allowlist before running any install command. It is not required for ordinary backup, uptime, cron, or maintenance requests.# OpenClaw RestoreWork with self-contained backup bundles produced by `openclaw-snapshot`.## Current restore modelThe primary restore path is now the bundled script inside each backup archive:```bashbash <bundle-dir>/restore.sh```Important:- do not rename the extracted bundle root directory before running `restore.sh`- the restore target basename must match the bundled source basename, which is normally `.openclaw`This restore skill now focuses on locating and extracting backup bundles.## List bundles and prepare restoreRun:```bashbash scripts/select_and_restore.sh```This script:- lists available `occt7pkbak-*.tar.gz` bundles by newest first- lets the operator choose one by number- audits tar entry paths and entry types before extraction- extracts the selected bundle to `/tmp`- prints the exact `bash .../restore.sh` command to run## Legacy noteThe old raw-snapshot restore flow has been retired in favor of the self-contained bundle format.If you directly run `scripts/restore_snapshot.sh`, it will tell you to use the bundled `restore.sh` instead.## Optional flags- `--snapshot-dir DIR`- `--prefix NAME`Environment variables:- `OPENCLAW_SNAPSHOT_DIR`- `OPENCLAW_SNAPSHOT_PREFIX`## Safety notes- The helper script audits archive structure, entry paths, and entry types before extraction, but you can still inspect the extracted bundle manually before restore.- Run the bundled `restore.sh` from the extracted bundle directory without renaming the extracted bundle root.- The bundled restore script enforces integrity verification and rejects symbolic links, special files, dangerous target paths, symbolic-link parent directories, and target paths whose basename does not match `.openclaw`.- Keep the generated pre-restore backup until you confirm the restored state is correct.

Frequently asked questions