openclaw uninstall: Remove Gateway Service and Local Data
This page covers the openclaw uninstall command, which removes the Gateway service and local data without deleting the CLI itself. It is for users who need to cleanly uninstall components while keeping the CLI tool.
Read this when
- You want to remove the gateway service and/or local state
- You want a dry-run first
openclaw uninstall
Removing the Gateway service and/or local data does not delete the CLI itself. Use npm or pnpm separately to uninstall the CLI tool.
Options
| Flag | Default | Description |
|---|---|---|
--service | false | Deletes the Gateway service. |
--state | false | Erases configuration and state data. |
--workspace | false | Removes workspace folders. |
--app | false | Uninstalls the macOS application. |
--all | false | Equivalent to --service --state --workspace --app. |
--yes | false | Proceeds without asking for confirmation. |
--non-interactive | false | Suppresses prompts; --yes must be set. |
--dry-run | false | Shows what would be done but does not delete files. |
When no scope flags are provided, an interactive multiselect asks which components to delete. By default, service, state, and workspace are 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
- Before removing state or workspaces, run
openclaw backup createfirst so you can restore them later. - Choosing
--stateleaves configured workspace directories untouched unless--workspaceis also picked.