[使用指南] OpenClaw AI机器人现已支持原生备份命令 可完整备份所有数据

此前 OpenClaw AI 机器人项目没有官方的备份方案，以至于蓝点网自己写脚本将整个工作区目录全部实时增量同步到 NAS 上，尤其是会话类数据可能包含多种日常沟通的细节 (记忆)，所以做好备份还是非常有必要的。

在开源社区中现在也有多种技能可以用来完整打包压缩工作区进行备份，这些备份方案主要都是将文件打包压缩，虽然也可以使用但无法验证数据是否完整 / 是否可用等。

所以现在 OpenClaw v2026.3.8 版中新增原生备份命令和验证命令，可以使用命令快速执行带有时间戳标记的备份文件，还可以使用命令对备份文件进行验证检查是否有效。

原生备份功能的优势：

可以将本地配置信息、状态数据、认证凭证、会话以及可选工作区打包为标准归档文件，用户可以在后续重置、卸载、迁移或故障恢复前留档以及进行恢复。

原本我们使用的手写脚本主要是将整个 ~/.openclaw 目录备份起来，这无法核对结构是否完整，官方备份命令则可以提前预览并校验，让所有用户都可以不用自己手写脚本或使用技能实现完整的数据备份。

备份归档记录的结构：

原生备份功能将在备份文件内部生成 manifest.json 文件，该文件用来记录备份创建时间、归档根目录、Runtime 版本、平台与 Node.js 版本、实际纳入归档的源路径、被跳过的路径和原因、归档内部 payload 的映射关系。

这个文件属于结构说明可以用来后续进行核对，这也是能够使用验证命令检查备份文件是否完整的原因。

特别注意：

请不要将备份目的地设置为 OpenClaw 目录本身防止出现循环备份问题，备份命令已经会拦截这种危险写法，备份目录建议放到独立的路径。

例如安装目录为：/home/landian/.openclaw/

那备份可以放在：/home/landian/backup/

基本使用方法：

前置条件：必须将 OpenClaw 升级到 v2026.3.8 或更高版本

#归档创建校验：(建议使用此命令)
openclaw backup create --verify
#创建归档：(将备份存储在当前目录、不带校验)
openclaw backup create 
#指定路径：
openclaw backup create --output ~/home/backup
#提前预览：该命令可预览备份信息但不会真备份
openclaw backup create --dry-run --json 
#指定归档文件校验：
openclaw backup verify ./具体备份文件.tar.gz

高级使用方法：

排除工作区：工作区往往是体积最大的部分，如果你只想备份核心状态、配置、凭据等就可以排除工作区

openclaw backup create --no-include-workspace

仅备份活动：如果你只想备份活动配置而不关心会话状态、OAuth 凭据或工作区内容

openclaw backup create --only-config

建议创建定时任务：

需要注意的是这个备份命令本身没有定时器，所以建议用户自行配置定时备份任务例如每天夜里 03:00 备份 1 次并只保留最近 7 天的备份，这样既不需要手动操作也不会因为备份文件太多塞爆硬盘。

如何创建定时任务 (参考提示词)：

请阅读这个 PR 所说的功能：https://github.com/openclaw/openclaw/pull/40163 我需要你在每天夜里 03:00 备份 1 次并对归档文件进行验证，只保留最近 7 天的备份，请帮我创建定时备份任务。如果备份失败或归档验证失败请立即告诉我。