Skip to main content

​
openclaw uninstall

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

​
Options

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

​
Examples

​
Notes

Uninstall reports each requested scope and exits nonzero if any requested cleanup fails or is blocked. A failed gateway service inspection, stop, or uninstall blocks state and workspace mutation, but independent macOS app cleanup is still attempted. After service teardown is safe, other permitted scopes continue so failures can be reported together. On non-macOS systems, --app reports that the scope is not applicable.
  • 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.