Files
openclaw/docs/cli/uninstall.md
T
Peter Steinberger b834477565 fix(cli): refuse live state reset and uninstall (#125253)
* fix(cli): guard live state cleanup

* fix(cli): preserve linked paths on cleanup failure

* fix(cli): retain gateway ownership through cleanup

* fix(cli): keep cleanup planning read-only

* fix(cli): skip mutating bootstrap for cleanup

* fix(apple): keep identity locks sandbox-writable

* docs(apple): clarify identity lock domains
2026-08-17 09:44:31 -07:00

2.1 KiB

summary, read_when, title
summary read_when title
CLI reference for `openclaw uninstall` (remove gateway service + local data)
You want to remove the gateway service and/or local state
You want a dry-run first
Uninstall

openclaw uninstall

Uninstall the Gateway service and/or local data. The CLI itself is not removed; uninstall it via npm/pnpm separately.

Options

Flag Default Description
--service false Remove the Gateway service.
--state false Remove state and config.
--workspace false Remove workspace directories.
--app false Remove the macOS app.
--all false Shorthand for --service --state --workspace --app.
--yes false Skip confirmation prompts.
--non-interactive false Disable prompts; requires --yes.
--dry-run false Print planned actions without removing files.

With no scope flags, an interactive multiselect prompts for which components to remove (defaults to service, state, workspace preselected).

Examples

openclaw backup create
openclaw uninstall
openclaw uninstall --service --yes --non-interactive
openclaw uninstall --state --workspace --yes --non-interactive
openclaw uninstall --all --yes
openclaw uninstall --dry-run

Notes

  • Run openclaw backup create first for a restorable snapshot before removing state or workspaces.
  • Before removing state, --state requires exclusive state ownership. If an unmanaged or externally supervised Gateway is still running, uninstall refuses and asks you to stop it first.
  • --state preserves configured workspace directories unless --workspace is also selected.