Lifecycle guide · Independent guidance

Uninstall OpenClaw completely—or keep the parts you need

`openclaw uninstall` removes selected Gateway service, state, workspace, and macOS app scopes; it does not remove the CLI package itself. Always create a backup and run `openclaw uninstall --dry-run` before choosing destructive scopes.

Current snapshotUpdated 2026-08-24Official docs main snapshot · OpenClaw 2026.8.1
01

Preserve before removing

  1. 1

    Create a backup

    Keep it outside any workspace or state directory you plan to remove.

    openclaw backup create --verify
  2. 2

    Preview scopes

    Review service, state, workspace, and app targets without deletion.

    openclaw uninstall --dry-run
  3. 3

    Choose the smallest scope

    For example, remove only the managed service while preserving state.

    openclaw uninstall --service
02

What “complete” means

  • `--all` expands to service, state, workspace, and macOS app scopes.
  • State removal refuses when the state still has a running owner.
  • Workspace directories are preserved unless the workspace scope is selected.
  • Remove a global npm/pnpm/bun package separately after confirming no desired service uses it.
  • Windows Hub and platform-specific companion apps can have their own uninstall entry.

Primary sources

Verify against the owner.

Content snapshot follows official docs main at the recorded commit; the current package metadata reported 2026.8.1 when verified. Your installed release and live CLI schema remain authoritative.