作为 OpenClaw 的深度玩家,你是否曾为了调优一个 Agent 的 Skill 熬到深夜?或者在 Workspace 里积累了无数珍贵的执行记录?
在 IT 圈有一句名言:“世界上只有两种人,一种是已经丢了数据的,另一种是正在去丢数据路上的。”
好消息是,从 OpenClaw 3.8 版本开始,官方正式将备份功能集成到了核心 CLI 中。这意味着你不再需要依赖不稳定的外部脚本或手动复制,原生支持的 openclaw backup 已经成为了你数字资产最坚实的护盾。
今天,我将带大家拆解 3.8+ 版本的备份与恢复“金牌准则”。
01. 兵马未动,粮草先行:建立统一战线
即便有了原生支持,良好的文件管理习惯依然是成功的基石。在开始前,我们先建立两个“神圣不可侵犯”的目录:
# 存放正式备份包(压缩态) mkdir -p ~/Backups/OpenClaw# 存放临时校验数据(解压态,随时可删) mkdir -p /tmp/openclaw-backup-inspect02. 3.8+ 原生力量:创建即验证
在 3.8 之前的版本,备份往往是“黑盒”操作。而现在的 openclaw backup 工具不仅备份 state、config、credentials,还支持原生的 --verify 参数,确保备份完即刻处于“立等可用”状态。
一键备份指令:
openclaw backup create --output ~/Backups/OpenClaw --verify(Version 3.8+): > 3.8 版本的重大意义在于它将 verify(校验)逻辑内置到了备份流中。这个操作会一口气带走你的所有核心资产(含 OAuth 凭据)。建议升级到 3.8+,体验这种“原生安全感”。
03. 深度拆解: manifest.json
原生备份生成的 manifest.json 是备份包的“灵魂索引”。通过它,你可以清晰看到 3.8 版本是如何处理路径映射的。
实操演示:解压并探秘
找到最新备份并解压
BACKUP_FILE=$(ls -t ~/Backups/OpenClaw/*.tar.gz | head -1) tar -xzf "$BACKUP_FILE" -C /tmp/openclaw-backup-inspect找到灵魂文件 manifest.json
MANIFEST=$(find /tmp/openclaw-backup-inspect -name manifest.json | head -1) echo "$MANIFEST"关注的三个关键字段
1. paths.oauthDir:明确 OpenClaw 寻找凭据的真实绝对路径。 2. assets[].archivePath:物理文件在 Payload 布局中的入口。 3. skipped.reason = "covered":OpenClaw 3.8 优化了打包逻辑,如果目录重叠会自动去重,避免备份包过度膨胀。
04. 写在最后:关于“恢复”的哲学
OpenClaw 3.8 的发布,标志着这款工具从“极客玩具”向“生产力工具”的又一迈进。
通过本次演练,你已经掌握了:
1. 调用 3.8+ 原生指令生成验证包。 2. 解读 清单文件,明确版本特有的 Payload 布局。
最后,送给大家一句话:在 OpenClaw 的时代,不备份已经不再是因为工具难用,而是因为你还不够爱你的 Agent。
附录
{ "schemaVersion": 1, "createdAt": "2026-03-31T16:06:41.671Z", "archiveRoot": "2026-03-31T16-06-41.671Z-openclaw-backup", "runtimeVersion": "2026.3.28", "platform": "linux", "nodeVersion": "v24.14.1", "options": { "includeWorkspace": true, "onlyConfig": false }, "paths": { "stateDir": "/home/shake/.openclaw", "configPath": "/home/shake/.openclaw/openclaw.json", "oauthDir": "/home/shake/.openclaw/credentials", "workspaceDirs": [ "/home/shake/.openclaw/workspace" ] }, "assets": [ { "kind": "state", "sourcePath": "/home/shake/.openclaw", "archivePath": "2026-03-31T16-06-41.671Z-openclaw-backup/payload/posix/home/shake/.openclaw" } ], "skipped": [ { "kind": "workspace", "sourcePath": "/home/shake/.openclaw/workspace", "reason": "covered", "coveredBy": "~/.openclaw" } ]}
夜雨聆风