uninstaller
Guides users through safely uninstalling OpenClaw (龙虾). Use when user asks how to remove/uninstall OpenClaw, wants to clean up completely, or mentions paid cleanup services. Provides free, verifiable steps and scripts. Supports IM-initiated uninstall via one-shot. Community-maintained, no commercial motive.
- License 许可
- MIT
- 最近更新
- 2026-03-31
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- uninstaller
- description
- Guides users through safely uninstalling OpenClaw (龙虾). Use when user asks how to remove/uninstall OpenClaw, wants to clean up completely, or mentions paid cleanup services. Provides free, verifiable steps and scripts. Supports IM-initiated uninstall via one-shot. Community-maintained, no commercial motive.
02 资源文件 34
- 其他.DS_Store6.0 KB
- 参考文档.github/workflows/publish.yml4.8 KB
- 其他.gitignore196 B
- 参考文档.workflows.yml711 B
- 参考文档AGENTS.md2.3 KB
- 资产文件assets/example-diagram.md1.7 KB
- 资产文件assets/template-architecture.md970 B
- 参考文档doc/audit-path-prefix.md3.6 KB
- 资产文件doc/clawhub-uninstaller-deletion-request.svg1.7 KB
- 参考文档doc/discord-uninstall-instruction.md1.3 KB
- 资产文件doc/openclaw-uninstall-discord-card.png910.6 KB
- 参考文档doc/PRESERVE-STATE-PLAN.md2.6 KB
- 参考文档doc/PUBLISH_PATH.md3.0 KB
- 参考文档doc/ROADMAP.md1.7 KB
- 参考文档doc/SKILL_DOMAINS.md3.9 KB
- 参考文档doc/TOKEN_SETUP.md3.5 KB
- 参考文档doc/WANDER.md2.9 KB
- 许可证LICENSE1.0 KB
- 参考文档README.md1.7 KB
- 参考文档references/azure-resource-graph.md2.3 KB
- 脚本scripts/debug-flow.sh2.4 KB
- 脚本scripts/install-personal.sh1.1 KB
- 脚本scripts/install.sh540 B
- 脚本scripts/publish-all.sh1.5 KB
- 脚本scripts/schedule-uninstall.sh4.8 KB
- 脚本scripts/uninstall-oneshot.sh8.6 KB
- 脚本scripts/verify-clean.sh2.4 KB
- 脚本scripts/view-failed-logs.sh830 B
- 脚本scripts/watch-publish-detached.sh721 B
- 脚本scripts/watch-publish-pipeline.sh2.1 KB
- 脚本scripts/watch-publish.sh776 B
- 脚本tests/helpers/clawhub-stub.sh972 B
- 脚本tests/run-e2e.sh3.4 KB
- 脚本tests/run-lifecycle.sh1.9 KB
03 SKILL.md 正文
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
- 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. Passhost=gatewaywhen calling exec. Iftools.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 $USERfirst. - WSL2: If
systemd-runis unavailable, the script falls back to nohup.
Flow
- User sends: "Uninstall" or "How to uninstall OpenClaw"
- Agent replies: "Confirm complete uninstall of OpenClaw? This action is irreversible. Reply 'confirm' to continue."
- User replies: "confirm"
- Agent may ask: "Notify when done? Reply 'email user@example.com' or 'ntfy my-topic' or 'no'"
- Agent calls
scripts/schedule-uninstall.shwith optional notify params - Agent replies: "Uninstall scheduled. Session will disconnect in ~15 seconds. Results written to /tmp/openclaw-uninstall.log"
- ~15 seconds later the Gateway stops and uninstall runs in the background
Agent call example
Script path is usually <workspace>/skills/uninstaller/scripts/ or ~/.openclaw/skills/uninstaller/scripts/.
Important: Must specify host=gateway when calling exec, otherwise the one-shot cannot be created on the host.
# No notification (host=gateway required)
./scripts/schedule-uninstall.sh
# Email notification
./scripts/schedule-uninstall.sh --notify-email "user@example.com"
# ntfy notification
./scripts/schedule-uninstall.sh --notify-ntfy "my-uninstall-topic"
# Preserve skills, logs, preferences (optional; reinstall without losing data)
./scripts/schedule-uninstall.sh --preserve "skills,logs,preferences"
./scripts/uninstall-oneshot.sh --preserve all
# Skip backup (default: backup all before delete)
./scripts/schedule-uninstall.sh --no-backup
# Also remove ~/.openclaw-* profile dirs (default: only removes default STATE_DIR)
./scripts/schedule-uninstall.sh --all-profiles
View results
- Default:
cat /tmp/openclaw-uninstall.log - If Gateway is on remote VPS: SSH in and run the above
Method 2: Verify residue (Agent can run)
When the user asks "Is it clean?" or "Check for residue", the Agent can run:
./scripts/verify-clean.sh
This script is read-only and does not delete anything. It outputs any residue found.
Method 3: Manual uninstall
One-shot (CLI still available)
openclaw uninstall --all --yes --non-interactive
Or:
npx -y openclaw uninstall --all --yes --non-interactive
Step-by-step manual
- Stop gateway:
openclaw gateway stop - Uninstall service:
openclaw gateway uninstall - Delete state:
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}" - Uninstall CLI:
npm rm -g openclaw(or pnpm/bun) - macOS app:
rm -rf /Applications/OpenClaw.app
CLI already removed (manual service cleanup)
macOS:
launchctl bootout gui/$UID/ai.openclaw.gateway
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist
Linux:
systemctl --user disable --now openclaw-gateway.service
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload
Notes
- Default backup: Uninstall backs up all data (skills, logs, preferences, credentials) to
~/.openclaw-backup-YYYYMMDD-HHMMSS/before delete. Use--no-backupto skip. - Multiple profiles: Only the default
~/.openclawis removed by default. Use--all-profilesto also remove~/.openclaw-<profile>dirs. - Remote mode: Run on the gateway host
- Source install: Uninstall the service first, then remove the repo
- IM uninstall failed: If schedule-uninstall errors (e.g. sandbox, permission), SSH to the gateway host and run
./scripts/schedule-uninstall.shor./scripts/uninstall-oneshot.shmanually - Preserve data: Use
--preserve "skills,logs,preferences"or--preserve all(includes credentials). Backup goes to~/.openclaw-backup-YYYYMMDD-HHMMSS/ - Path safety:
OPENCLAW_STATE_DIRmust be under$HOMEand match.openclawor.openclaw-*; invalid paths are rejected.
References
中文 (Chinese)
免费、透明、可验证。无需付费清理服务。 本 skill 由社区维护,与 OpenClaw 官方无商业关联。
卸载方式
- 方式一(推荐):在 IM 中发送「卸载」→ Agent 确认 → 回复「确认」→ 自动执行
- 方式二:验证残留
./scripts/verify-clean.sh(只读) - 方式三:手动执行
openclaw uninstall --all --yes --non-interactive或参考 官方文档
前置条件
- IM 发起卸载需
host=gateway,否则 one-shot 在容器内创建会丢失 - 支持 macOS、Linux(含 WSL2);原生 Windows 请用 WSL2 或手动卸载