Skip to main content

​
openclaw uninstall

Uninstall the Gateway service and/or local data. There is no separate CLI-removal scope. Remove any remaining CLI through the installation-specific steps.

​
Options

With no scope flags, an interactive multiselect prompts for which components to remove (defaults to the Gateway service only). Take an archive with openclaw backup first if you may want the state back.

​
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.