Files
openclaw/docs/cli/uninstall.md
Peter Steinberger f7d7148cf0 docs: rewrite published docs grounded in current source (#100142)
Source-grounded rewrite of 529 published docs pages with per-unit information-loss verification: 1,713 factual corrections cited to src/**, generated surfaces regenerated, frontmatter titles preserved for i18n, release notes pages untouched. All docs gates green.

Closes #100141
2026-07-05 00:32:47 -04:00

52 lines
1.9 KiB
Markdown

---
summary: "CLI reference for `openclaw uninstall` (remove gateway service + local data)"
read_when:
- You want to remove the gateway service and/or local state
- You want a dry-run first
title: "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
```bash
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](/cli)
- [Uninstall](/install/uninstall)