mirror of
https://github.com/openclaw/openclaw.git
synced 2026-06-05 04:12:51 +00:00
e74931778c
Preserve workspace directories when `openclaw uninstall --state` removes local state, including configured workspaces and implicit per-agent workspaces resolved by the runtime. State-only uninstall now uses a cleanup plan that keeps those workspace roots unless `--workspace` is selected. Fixes #75052. Proof: - `git diff --check origin/main...HEAD` - `pnpm exec oxfmt --check --threads=1 src/commands/cleanup-utils.ts src/commands/cleanup-utils.test.ts src/commands/uninstall.ts src/commands/uninstall.test.ts docs/cli/uninstall.md docs/install/uninstall.md` - `node scripts/run-vitest.mjs src/commands/uninstall.test.ts src/commands/cleanup-utils.test.ts src/commands/reset.test.ts src/commands/agents.delete.test.ts` - `node scripts/run-tsgo.mjs -p test/tsconfig/tsconfig.core.test.json --incremental --tsBuildInfoFile /tmp/openclaw-pr75061-core-test-final-rebase2.tsbuildinfo` - `pnpm docs:list` - `node scripts/check-docs-mdx.mjs docs/cli/uninstall.md docs/install/uninstall.md` - `.agents/skills/autoreview/scripts/autoreview --mode branch --base origin/main` - CI: https://github.com/openclaw/openclaw/actions/runs/26721260691 Co-authored-by: Jason-Bai <boybai.work@gmail.com>
46 lines
1.3 KiB
Markdown
46 lines
1.3 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 + local data (CLI remains).
|
|
|
|
Options:
|
|
|
|
- `--service`: remove the gateway service
|
|
- `--state`: remove state and config
|
|
- `--workspace`: remove workspace directories
|
|
- `--app`: remove the macOS app
|
|
- `--all`: remove service, state, workspace, and app
|
|
- `--yes`: skip confirmation prompts
|
|
- `--non-interactive`: disable prompts; requires `--yes`
|
|
- `--dry-run`: print actions without removing files
|
|
|
|
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 if you want a restorable snapshot before removing state or workspaces.
|
|
- `--state` preserves configured workspace directories unless `--workspace` is also selected.
|
|
- `--all` is shorthand for removing service, state, workspace, and app together.
|
|
- `--non-interactive` requires `--yes`.
|
|
|
|
## Related
|
|
|
|
- [CLI reference](/cli)
|
|
- [Uninstall](/install/uninstall)
|