A professional cleanup utility and guide for fully removing OpenClaw components, system services, and configuration data from any OS.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openclaw-uninstaller
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install openclaw-uninstaller using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is OpenClaw Uninstaller?
The openclaw-uninstaller is a technical framework designed to help developers safely and thoroughly remove the OpenClaw environment from their systems. It addresses the need for clean offboarding when API costs become unsustainable or when a fresh environment reset is required. By following these Openclaw Skills, users can ensure that hidden background processes, global CLI packages, and local state directories are purged, preventing orphaned services from consuming system resources or incurring unexpected billing.
OpenClaw Uninstaller Use Cases
- Terminating high-cost AI API billing cycles by removing active agents.
- Performing a factory reset of the OpenClaw environment to resolve configuration conflicts.
- Cleaning up system-level services and background gateways on macOS, Linux, or Windows.
- Managing disk space by deleting local workspaces and multi-profile state data.
How OpenClaw Uninstaller Works
- The uninstaller first identifies all active OpenClaw processes and gateway services associated with your Openclaw Skills.
- It stops the gateway service to release network ports and system hooks.
- The tool executes a removal of the global CLI binary via the user's package manager (npm, pnpm, or bun).
- It recursively deletes state directories, including the .openclaw configuration and workspace folders.
- Finally, it unregisters system-specific services like macOS LaunchAgents, Linux systemd units, or Windows Scheduled Tasks to ensure a permanent cleanup.
OpenClaw Uninstaller Setup
To perform a rapid removal using these Openclaw Skills, execute the following command in your terminal:
npx -y openclaw uninstall --all --yes --non-interactive
For manual package removal after stopping services, use:
npm rm -g openclaw
# Or for pnpm users
pnpm remove -g openclaw
OpenClaw Uninstaller Data Schema & Taxonomy
The uninstaller targets the following data structures and paths to ensure no residue remains:
| Component | Default Path | Description |
|---|---|---|
| State Directory | ~/.openclaw |
Core configuration, logs, and profile data. |
| Workspace | ~/.openclaw/workspace |
Local storage for agent-generated code. |
| macOS App | /Applications/OpenClaw.app |
The GUI wrapper for desktop users. |
| Systemd Unit | ~/.config/systemd/user/openclaw-gateway.service |
Background service definition on Linux. |
| LaunchAgent | ~/Library/LaunchAgents/ai.openclaw.gateway.plist |
Background service definition on macOS. |
OpenClaw Uninstaller Advanced Features
- Support for --all and --non-interactive flags for automated, headless environment decommissioning.
- Multi-profile detection to clean up secondary state directories like ~/.openclaw-profile-name.
- Platform-specific system service cleanup for Windows Task Scheduler and Linux systemd.
- Remote mode support for cleaning up gateways on distributed server instances.
SKILL.md
Loading
Related Openclaw Skills
OpenClaw Professional Installer
A professional-grade CLI installer designed to simplify the deployment of the OpenClaw agent ecosystem and dashboard.
CAD Skills
A specialized automation skill for controlling local Windows CAD applications including SolidWorks, CATIA, and Siemens NX through an AI agent.
agent-mineru
A high-performance document parsing CLI that transforms PDFs, Office files, and images into structured Markdown and JSON using advanced layout analysis.
Focus Tracker
A persistent context management system that uses a dedicated Markdown file to track active project state, preventing AI agents from losing track of their work.
Client Relationship Management
A structured framework for AI agents to manage professional client relationships from first contact through long-term growth.
Proposal Skill
Transform vague service ideas into structured, persuasive proposals designed to drive clear stakeholder decisions.
Featured*
