mirror of https://github.com/openclaw/openclaw.git synced 2026-06-03 22:44:14 +00:00

Files

Jason e74931778c fix: preserve workspaces during state-only uninstall

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>

2026-05-31 19:54:34 +01:00

1.3 KiB

Raw Blame History

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 + 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:

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.

1.3 KiB Raw Blame History

openclaw uninstall

Related

1.3 KiB

Raw Blame History

`openclaw uninstall`