openclaw/docs/cli/uninstall.md

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; remove it separately using the method that installed it. See the complete uninstall guide.

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

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.

Related

• CLI reference
• Uninstall