{"item":{"id":"wf-backup-restore","product":"openclaw","language":"en","title":"Verify a backup by restoring into a separate directory","summary":"Real Windows x64 and macOS ARM64 CLI runs restored all five fictional files. Config-only restored the root JSON but omitted its include file. Corrupt archives and occupied targets were refused; gateway recovery was not tested.","contentType":"guide","category":"deployment","revision":10,"canonicalUrl":"https://botclaw.tech/items/wf-backup-restore","sourceUrls":["https://docs.openclaw.ai/cli/backup","https://github.com/openclaw/openclaw/releases/tag/v2026.9.6"],"sourcePublishedAt":"2026-10-01T13:51:23.773Z","reviewedAt":"2026-10-02T08:27:29.747Z","collectedAt":"2026-10-01T13:51:23.773Z","updatedAt":"2026-11-12T17:30:55.184Z","source":{"id":"botclaw-editorial","name":"BotClaw","origin":"editorial"},"summaryMethod":"editor","applicability":{"version":"OpenClaw 2026.9.6 / Node.js 24.16.0","platforms":["Windows x64 (native CLI)","macOS ARM64"],"requirements":["Pinned Node 24.16.0 and an independently installed OpenClaw 2026.9.6 with its platform dependencies","A fresh local trial directory and the downloaded verification script","For personal backups: protected storage because archives can contain authentication material"]},"verification":{"kind":"software_execution","checkedAt":"2026-10-02T08:06:07.892Z","urls":["https://docs.openclaw.ai/cli/backup","https://botclaw.tech/examples/openclaw-backup-check.mjs","https://botclaw.tech/evidence/openclaw-backup.json"],"limitations":["Five fictional files were restored and hash-checked on Windows x64 and macOS ARM64. No production credentials, live session database or channels were copied.","No gateway activation, model response, memory behavior, messaging or scheduled task was tested.","The Windows test install initially omitted native Koffi dependencies; including the locked platform dependencies resolved it."]},"body":{"introduction":"The downloadable trial uses an isolated home, state and workspace with no credentials. Both hosts ran the same script with OpenClaw 2026.9.6 and Node 24.16.0. It checks staging restoration by comparing file hashes; it does not activate the restored configuration.","sections":[{"heading":"Inspect and create","paragraphs":[],"steps":["Run the dry-run inventory and compare included paths with your recovery list. Keep the report private if it exposes account paths.","Create the backup with verification enabled. Store the archive in a separate protected location and record its checksum privately.","Verify the archive and restore into a new empty test directory. Do not target the active configuration or overwrite a working gateway."],"code":"openclaw backup create --dry-run --json\nopenclaw backup create --verify\nopenclaw backup verify <archive>\nopenclaw backup restore <archive> --target ./restored-openclaw"},{"heading":"Reproduce with public inputs","paragraphs":["Download the script under Evidence files and run it with the pinned runtime. --cli points to openclaw.mjs beside its package.json; --out must be a new directory. The script passes explicit isolated paths and copies no existing profile. Keep its private logs locally."],"code":"node openclaw-backup-check.mjs --cli /absolute/path/to/openclaw/openclaw.mjs --out ./new-backup-trial"},{"heading":"Observed results","paragraphs":["Full backup restored root config, its include file, AGENTS.md, MEMORY.md and a fictional session-note file on both hosts. --only-config restored just the root config. Verification and restoration rejected a truncated archive; restoration preserved an occupied target; creation refused an existing archive."]},{"heading":"Recovery still needs a runtime check","paragraphs":["The session note proves byte restoration, not a usable Agent session. Restored config retains the original workspace path. Before activating a personal restore, inspect paths and the actual session database, then run an isolated baseline with separate authorization for gateway startup. Never use the disposable trial to overwrite a working profile."]}]},"indexable":true,"supersededBy":null,"review":{"state":"pending","pendingChanges":6,"policyDays":7}}}