openclaw backup 创建本地备份归档，包含 OpenClaw 状态、配置、认证 profiles、凭据、sessions，以及可选的 workspace。
常用命令
openclaw backup create # 创建完整备份（当前目录）
openclaw backup create --output ~/Backups # 指定输出目录
openclaw backup create --dry-run --json # 预览备份内容
openclaw backup create --verify # 创建后立即验证
openclaw backup create --no-include-workspace # 排除 workspace
openclaw backup create --only-config # 仅备份配置文件
openclaw backup verify ./2026-03-09T00-00-00.000Z-openclaw-backup.tar.gz备份内容
| 内容 | 说明 |
|---|---|
~/.openclaw 状态目录 | 包含 agents/*/agent/auth-profiles.json |
| 活跃配置文件 | openclaw.json |
credentials/ 目录 | 若在状态目录外 |
| workspace 目录 | 默认包含，--no-include-workspace 可排除 |
跳过的文件：活跃 session 转录、cron 运行日志、滚动日志、投递队列、socket/pid/temp 文件。
插件：包含 extensions/ 下的插件源码和 manifest，但跳过 node_modules/（可重建）。
选项说明
--only-config：最小备份，仅归档配置文件，不依赖配置解析（配置损坏时也可用）--no-include-workspace：跳过 workspace 发现，适合配置损坏时的部分备份--verify：创建后验证归档完整性（检查 manifest 和 payload 一致性）
归档特性
- 默认输出为带时间戳的
.tar.gz，不覆盖已有文件 - 包含
manifest.json，记录源路径和归档布局 - 若当前目录在备份源树内，自动回退到 home 目录
- 路径规范化：config/credentials/workspace 若已在状态目录内，不重复归档
配置损坏时的备份
# 配置损坏但需要备份时
openclaw backup create --no-include-workspace
# 或仅备份配置文件
openclaw backup create --only-config相关链接
- cli-reset — 重置本地状态
- cli-uninstall — 卸载 Gateway 和数据