openclaw backup

创建 OpenClaw 状态、配置、凭据、会话（以及可选的工作区）的本地备份归档。

openclaw backup create
openclaw backup create --output ~/Backups
openclaw backup create --dry-run --json
openclaw backup create --verify
openclaw backup create --no-include-workspace
openclaw backup create --only-config
openclaw backup verify ./2026-03-09T00-00-00.000Z-openclaw-backup.tar.gz

注意事项

  • 归档文件中包含一个 manifest.json，记录了解析后的源路径和归档布局。
  • 默认输出是一个带时间戳的 .tar.gz 文件，放在当前工作目录下。
  • 如果当前工作目录在某个备份源目录树内，OpenClaw 会回退到你的用户主目录作为默认归档位置。
  • 已有的归档文件不会被覆盖。
  • 输出路径如果在源状态/工作区目录树内会被拒绝，以避免自引用。
  • openclaw backup verify <archive> 会验证归档是否恰好包含一个根 manifest，拒绝遍历型归档路径，并检查 manifest 中声明的每个文件是否都在 tarball 中。
  • openclaw backup create --verify 在写入归档后立即执行验证。
  • openclaw backup create --only-config 只备份当前活跃的 JSON 配置文件。

备份内容

openclaw backup create 会从你的本地 OpenClaw 安装中规划备份源：

  • OpenClaw 本地状态解析器返回的状态目录，通常是 ~/.openclaw
  • 当前活跃的配置文件路径
  • OAuth / 凭据目录
  • 从当前配置中发现的工作区目录（除非你传了 --no-include-workspace）

如果使用 --only-config，OpenClaw 会跳过状态、凭据和工作区发现，只归档活跃配置文件的路径。

OpenClaw 在构建归档前会规范化路径。如果配置、凭据或工作区已经在状态目录内，不会作为单独的顶层备份源重复打包。缺失的路径会被跳过。

归档的 payload 存储这些源目录树中的文件内容，内嵌的 manifest.json 记录了解析后的绝对源路径以及每个资产使用的归档布局。

配置无效时的行为

openclaw backup 故意绕过正常的配置预检，这样在恢复场景下仍然能派上用场。由于工作区发现依赖有效的配置，当配置文件存在但无效且工作区备份仍启用时，openclaw backup create 会快速失败。

如果在这种情况下你仍然需要部分备份，重新运行：

openclaw backup create --no-include-workspace

这样会保留状态、配置和凭据，同时完全跳过工作区发现。

如果你只需要配置文件本身的副本，--only-config 在配置格式错误时也能工作，因为它不依赖解析配置来发现工作区。

大小和性能

OpenClaw 没有内置的最大备份大小或单文件大小限制。

实际限制来自本地机器和目标文件系统：

  • 临时归档写入加上最终归档所需的可用空间
  • 遍历大型工作区目录树并压缩为 .tar.gz 所需的时间
  • 使用 openclaw backup create --verify 或运行 openclaw backup verify 时重新扫描归档的时间
  • 目标路径的文件系统行为。OpenClaw 优先使用不覆盖的硬链接发布步骤，当硬链接不支持时回退到独占复制

大型工作区通常是归档大小的主要因素。如果你想要更小或更快的备份，使用 --no-include-workspace。

要得到最小的归档，使用 --only-config。

下一页
Overview
arrow_forward