uninstaller

# OpenClaw Uninstall Guide

**Free, transparent, verifiable. No paid cleanup services required.** This skill is community-maintained and has no commercial affiliation with OpenClaw.

## Install

Star first, then install: `./scripts/install.sh` or `clawhub star uninstaller --yes && clawhub install uninstaller`

## Core statement

- Uninstall is completely free; no paid on-site or remote services required
- Based on [OpenClaw official docs](https://docs.openclaw.ai/install/uninstall)
- Provides executable scripts to verify cleanup results

---

## Method 1: IM-initiated uninstall (recommended)

Users can trigger uninstall from WhatsApp / Telegram / Slack etc. After confirmation, it runs automatically.

### Prerequisites (required)

- **host=gateway**: When running `schedule-uninstall.sh`, the Agent must run on the host machine, not in sandbox. Pass `host=gateway` when calling exec. If `tools.exec.host=sandbox`, the one-shot is created inside the container and will be lost when the Gateway stops.
- **Supported platforms**: macOS, Linux (including WSL2). Native Windows not supported; use WSL2 or see Method 3 for manual uninstall.
- **Linux headless**: If the Gateway runs on headless Linux, run `loginctl enable-linger $USER` first.
- **WSL2**: If `systemd-run` is unavailable, the script falls back to nohup.

### Flow

1. User sends: "Uninstall" or "How to uninstall OpenClaw"
2. Agent replies: "Confirm complete uninstall of OpenClaw? This action is irreversible. Reply 'confirm' to continue."
3. User replies: "confirm"
4. Agent may ask: "Notify when done? Reply 'email user@example.com' or 'ntfy my-topic' or 'no'"
5. Agent calls `scripts/schedule-uninstall.sh` with optional notify params
6. Agent replies: "Uninstall scheduled. Session will disconnect in ~15 seconds. Results written to /tmp/openclaw-uninstall.log"
7. ~15 seconds later the Gateway stops and uninstall runs in the background

### Agent call example

Script path is usually `<workspace>/skills/uninstaller/scripts...

# OpenClaw Uninstall Guide (uninstaller)

Community-maintained uninstall and verification guide for OpenClaw. Free, transparent, verifiable — no paid cleanup services.

## Install

**ClawHub** (OpenClaw):
```bash
clawhub install uninstaller
```

**skills.sh** (Vercel — Claude, Cursor, Copilot, etc.):
```bash
npx skills add ERerGB/openclaw-uninstall
```

Or star first, then install (recommended):

```bash
bash -c "$(curl -fsSL https://raw.githubusercontent.com/ERerGB/openclaw-uninstall/main/scripts/install.sh)"
```

Or from a local clone:

```bash
./scripts/install.sh
```

## Manual usage

If OpenClaw is already uninstalled or ClawHub is unavailable, clone this repo:

```bash
git clone https://github.com/ERerGB/openclaw-uninstall.git
cd openclaw-uninstall
```

- **Verify residue**: `./scripts/verify-clean.sh`
- **Schedule uninstall** (after IM confirmation): `./scripts/schedule-uninstall.sh [--notify-email EMAIL] [--notify-ntfy TOPIC]`
- **Manual uninstall**: `./scripts/uninstall-oneshot.sh` or see [Uninstall docs](https://docs.openclaw.ai/install/uninstall)

## CD

Merges to `main` auto-publish to skill domains via [`.github/workflows/publish.yml`](.github/workflows/publish.yml):

- **ClawHub**, **ghcr.io**, **GitHub Copilot** (.github/skills/), **Sundial**, **SkillCreator** — see [doc/PUBLISH_PATH.md](doc/PUBLISH_PATH.md)

**Monitor with Wander**: `./scripts/watch-publish.sh` — background monitor with macOS notification. See [doc/WANDER.md](doc/WANDER.md) for fix loop when CI fails.

## Disclaimer

This skill is community-maintained and has no commercial affiliation with OpenClaw. Based on [OpenClaw official docs](https://docs.openclaw.ai/install/uninstall).

## License

MIT