openclaw-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; 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.
• --state preserves configured workspace directories unless --workspace is also selected.

Related

• CLI reference
• Uninstall