mirror of
https://github.com/openclaw/openclaw.git
synced 2026-08-24 03:15:46 -06:00
Peter Steinberger
b834477565
* fix(cli): guard live state cleanup * fix(cli): preserve linked paths on cleanup failure * fix(cli): retain gateway ownership through cleanup * fix(cli): keep cleanup planning read-only * fix(cli): skip mutating bootstrap for cleanup * fix(apple): keep identity locks sandbox-writable * docs(apple): clarify identity lock domains
55 lines
2.1 KiB
Markdown
55 lines
2.1 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.
|
|
- 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](/cli)
|
|
- [Uninstall](/install/uninstall)
|