openclaw/docs/cli/backup.md

1.0 KiB

summary read_when title
CLI reference for `openclaw backup` (create local backup archives)
You want a first-class backup archive for local OpenClaw state
You want to preview which paths would be included before reset or uninstall
backup

openclaw backup

Create a local backup archive for OpenClaw state, config, credentials, sessions, and optionally workspaces.

openclaw backup create
openclaw backup create --output ~/Backups
openclaw backup create --dry-run --json
openclaw backup create --no-include-workspace

Notes

  • The archive includes a manifest.json file with the resolved source paths and archive layout.
  • Default output is a timestamped .tar.gz archive in the current working directory.
  • If the current working directory is inside a backed-up source tree, OpenClaw falls back to your home directory for the default archive location.
  • Existing archive files are never overwritten.
  • Output paths inside the source state/workspace trees are rejected to avoid self-inclusion.