{"item":{"id":"wf-backup-restore","product":"openclaw","language":"zh","title":"通过独立目录恢复验证备份","summary":"Windows x64 与 macOS ARM64 的真实 CLI 演练均恢复了全部 5 个虚构文件。仅配置模式只恢复根 JSON，未包含引用文件；损坏归档和已有内容的目标被拒绝，gateway 运行恢复尚未测试。","contentType":"guide","category":"deployment","revision":10,"canonicalUrl":"https://botclaw.tech/items/wf-backup-restore?lang=zh","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":["固定 Node 24.16.0，并独立安装含本机依赖的 OpenClaw 2026.9.6","全新的本地演练目录与下载的核验脚本","个人备份需要保护存储，归档可能含认证资料"]},"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":["Windows x64 和 macOS ARM64 均恢复并校验 5 个虚构文件；没有复制生产凭据、真实会话数据库或渠道。","未测试 gateway 启用、模型回复、记忆行为、消息或定时任务。","Windows 测试安装最初遗漏原生 Koffi 依赖，补齐锁定版本的本机依赖后通过。"]},"body":{"introduction":"可下载演练使用隔离的 home、状态和工作区，不包含凭据。两台主机以 OpenClaw 2026.9.6 和 Node 24.16.0 执行同一脚本，通过文件哈希核对恢复到暂存目录的结果，不启用恢复后的配置。","sections":[{"heading":"检查和创建","paragraphs":[],"steps":["运行 dry-run 清单，对照恢复目标核对包含路径。报告出现账户路径时私下保存。","启用核验创建备份，存到独立保护位置，私下记录校验值。","核验归档，恢复到新建空测试目录，不指向当前配置或覆盖正在工作的 gateway。"],"code":"openclaw backup create --dry-run --json\nopenclaw backup create --verify\nopenclaw backup verify <archive>\nopenclaw backup restore <archive> --target ./restored-openclaw"},{"heading":"用公开输入复现","paragraphs":["在证据文件处下载脚本，以固定运行时执行。--cli 指向 package.json 旁的 openclaw.mjs，--out 必须是新目录。脚本传入明确隔离路径，不复制已有配置档；私下日志保留在本地。"],"code":"node openclaw-backup-check.mjs --cli /absolute/path/to/openclaw/openclaw.mjs --out ./new-backup-trial"},{"heading":"已观察结果","paragraphs":["两台主机的完整备份均恢复根配置、引用文件、AGENTS.md、MEMORY.md 和虚构会话说明文件。--only-config 只恢复根配置。核验和恢复均拒绝截断归档；恢复保留非空目标，创建拒绝覆盖已有归档。"]},{"heading":"运行恢复仍需另行验收","paragraphs":["会话说明只证明字节恢复，不能证明 Agent 会话可用。恢复配置保留原工作区路径。启用个人恢复前检查路径和实际会话数据库，再按另行授权的 gateway 启动范围运行隔离基线；不要用演练覆盖工作配置档。"]}]},"indexable":true,"supersededBy":null,"review":{"state":"pending","pendingChanges":6,"policyDays":7}}}