How to Uninstall OpenClaw Completely

Choose the right uninstall guide for your platform — Mac, Windows, Linux, or CLI. Step-by-step instructions to fully remove OpenClaw and verify a clean state.
Mar 13, 2026

Choose your platform

PlatformBest forGuide
macOSUsers who installed OpenClaw locally on a MacOpen the macOS guide
WindowsUsers who used a local install or Windows startup itemsOpen the Windows guide
LinuxUsers who used packages, shell setup, or systemd servicesOpen the Linux guide
CLI / npmUsers who installed via npm, pnpm, or bun globallyOpen the CLI guide

Quick path (all platforms)

If the openclaw command still works, this single command handles most of the cleanup:

openclaw uninstall --all --yes

Then remove the CLI itself:

npm rm -g openclaw

For the full story — including leftover checks, service removal, and verification — follow the platform-specific guide above.

What the uninstall covers

A complete OpenClaw uninstall includes:

  1. Stop and remove the gateway service — the background process that OpenClaw runs (launchd on Mac, systemd on Linux, scheduled task on Windows).
  2. Delete state and config — the ~/.openclaw directory and any custom config paths.
  3. Delete workspace — agent files stored in ~/.openclaw/workspace.
  4. Remove the CLI — the global npm/pnpm/bun package.
  5. Remove the macOS app/Applications/OpenClaw.app if installed.
  6. Clean up shell profile — remove OPENCLAW_* env vars, PATH entries, and aliases.
  7. Verify — reboot and confirm nothing restarts.

After uninstalling

Need deeper help?

How to Uninstall OpenClaw Completely