一文搞定：Ubuntu / macOS / Windows 下彻底卸载 OpenClaw 的完整指南

本文详细介绍了在Ubuntu、macOS和Windows系统上彻底卸载OpenClaw的完整步骤。主要内容包括：1. 通用卸载流程：停止服务、卸载npm全局包、删除配置文件目录；2. 各系统具体操作：Ubuntu需处理systemd服务，macOS需注意图形界面应用，Windows区分原生环境和WSL；3. 卸载后检查清单：验证命令、配置目录和服务进程是否完全清除。文章提供了清晰的操作指引，帮助用

小憨憨不敢.382

696人浏览 · 2026-03-12 11:32:35

小憨憨不敢.382 · 2026-03-12 11:32:35 发布

很多人尝试 OpenClaw 后，会遇到这些场景：

想重装，想先彻底卸载干净
换机器 / 换环境，不想保留任何残留
在不同系统上都装过，想统一清理
帮忙卸载还存在收费高昂的现象

这篇文章会分别说明 Ubuntu / macOS / Windows 三种环境下，如何完整卸载 OpenClaw，包括：

卸载 OpenClaw CLI（npm 全局包）
停止并移除服务（例如 systemd）
删除工作目录与配置文件

你可以按自己系统直接跳到对应章节操作。

一、通用说明：你可能装了哪些东西？

无论是 Ubuntu、macOS 还是 Windows，只要你是通过 Node/npm 安装的 OpenClaw，通常会包含：

全局 CLI 命令：
- 例如通过 npm install -g openclaw 安装
- 卸载命令通常是 npm uninstall -g openclaw
工作目录与配置：
- 默认在你的 Home 目录下：~/.openclaw
- 里面包含：
  - workspace/：你的 Agent 配置、记忆文件等
  - 日志、缓存等
可能的系统服务：
- Ubuntu：常见是 systemd 服务（openclaw-gateway.service 等）
- macOS：可能用 launchd 或手动用 tmux/screen 起服务
- Windows：可能通过 PowerShell / 计划任务 / pm2 等方式常驻运行

卸载时主要做三件事：

停止正在运行的 OpenClaw Gateway/服务
卸载全局 CLI（npm）
删除 .openclaw 工作目录（可选，看你是否要保留数据）

下面按系统展开。

二、在 Ubuntu 下卸载 OpenClaw

步骤 1：停止 OpenClaw Gateway

如果 openclaw 命令仍然可用，先尝试优雅停止：

openclaw gateway stop

如果你配置过 systemd 服务（比较常见），可以查一下：

systemctl list-units | grep openclaw

如果看到类似：

openclaw-gateway.service   loaded active running OpenClaw Gateway

则先停止并禁用：

sudo systemctl stop openclaw-gateway.service
sudo systemctl disable openclaw-gateway.service

如果你自己起的服务名不同（比如自定义的 ai-gateway.service 中跑的 OpenClaw），记得用对应名字。

步骤 2：卸载 npm 全局安装的 OpenClaw

大部分人在 Ubuntu 上都是用 npm 全局安装的：

npm install -g openclaw

对应卸载命令：

npm uninstall -g openclaw

如果你用的是 pnpm / yarn：

pnpm remove -g openclaw
# 或
yarn global remove openclaw

确认卸载完成：

which openclaw   # 应该没有输出或提示找不到

步骤 3：删除 OpenClaw 配置与工作目录（可选，但推荐）

默认情况下，OpenClaw 会在你的 home 目录下创建：

~/.openclaw

如果你完全不打算再用，可以直接删除：

rm -rf ~/.openclaw

如果你想保留数据（比如日后再装时沿用配置），可以先备份：

cp -r ~/.openclaw ~/openclaw-backup

然后再决定是否删除原目录。

步骤 4：可选清理：Node 缓存

如果你打算重装 Node / 重配环境，可以顺手清一下 npm 缓存：

npm cache clean --force

这不是必须步骤，只是顺手清理一下。

三、在 macOS 下卸载 OpenClaw

macOS 下一般有两种使用方式：

直接在终端通过 npm install -g openclaw 安装
配合 macOS 菜单应用（如果你用的是 OpenClaw.app，那是额外的 UI 外壳）

下面先说命令行部分。

步骤 1：停止 Gateway 或相关进程

如果你是用命令行启动的 Gateway：

openclaw gateway stop

如果你使用的是 OpenClaw.app 这种桌面应用，一般会：

在菜单栏有一个小图标
你可以从菜单里选择「Quit / 退出」来停止 Gateway

如果你自己通过 tmux、screen、pm2 等方式起的服务，需要先手动停止对应会话或进程。

步骤 2：卸载 npm 全局安装的 OpenClaw

与 Ubuntu 一样，如果你是用 npm 全局安装的：

npm uninstall -g openclaw

或对应的 pnpm / yarn：

pnpm remove -g openclaw
# 或
yarn global remove openclaw

检查：

which openclaw

如果返回空 / not found，则说明 CLI 已卸载。

步骤 3：删除配置和数据目录

同样，macOS 下的 Home 目录也是 ~，默认工作目录路径：

~/.openclaw

你可以选择：

rm -rf ~/.openclaw

或者先备份再删：

cp -r ~/.openclaw ~/openclaw-backup
rm -rf ~/.openclaw

步骤 4：如果你安装过 OpenClaw.app（图形界面）

如果你使用的是带 GUI 的 OpenClaw.app：

退出应用（从菜单栏 quit）
打开 Finder →「应用程序」(Applications)
找到 OpenClaw.app
拖到废纸篓（Trash），或者右键「移到废纸篓」

这个动作只会移除 GUI 程序，不会碰你的 ~/.openclaw 工作目录，所以记得结合上一步一起清理。

四、在 Windows（含 WSL）下卸载 OpenClaw

Windows 环境有两种典型情况：

纯 Windows + Node 环境（PowerShell / CMD 下 npm 安装）
WSL（例如 Ubuntu on Windows）里安装的 OpenClaw

这两种本质上类似，只是路径略不一样。

情况 A：在 Windows（非 WSL）里直接安装 OpenClaw

你可能是在 PowerShell 中运行过：

npm install -g openclaw

步骤 1：停止 Gateway

如果你有在 PowerShell / cmd 中开着 OpenClaw Gateway 进程，可以先暂停/关闭对应窗口。
如果你用的是 pm2 / 计划任务运行，需要先停掉：

pm2 方式示例：
```
pm2 stop openclaw
pm2 delete openclaw
```
计划任务 / 服务方式，则在任务计划程序或服务管理里禁用/删除。

步骤 2：卸载 npm 全局安装的 OpenClaw

在 PowerShell 中执行：

npm uninstall -g openclaw

或者：

pnpm remove -g openclaw
# 或
yarn global remove openclaw

检查是否卸载成功（可能需要重开一个终端）：

where openclaw

如果提示找不到该命令，说明已卸载。

步骤 3：删除配置和工作目录

在 Windows 上，Home 目录通常是：

C:\Users\<你的用户名>

OpenClaw 的配置目录一般会在：

C:\Users\<你的用户名>\.openclaw

你可以在文件资源管理器中直接打开路径：

%USERPROFILE%\.openclaw

然后：

如果你想完全清掉：直接右键删除 .openclaw 文件夹
如果想备份：复制一份到别的地方再删

情况 B：在 WSL 内安装的 OpenClaw

如果你是在 WSL 的 Linux 发行版（比如 Ubuntu-20.04）里执行的：

npm install -g openclaw

那卸载步骤其实和「Ubuntu 那一节」完全一致，只是在 WSL 终端里操作：

停止 Gateway：
```
openclaw gateway stop
```
卸载全局：
```
npm uninstall -g openclaw
```
删除工作目录：
```
rm -rf ~/.openclaw
```
如果你在 WSL 里也搞了 systemd/pm2 等服务，记得一并停掉。

五、卸载完成后的检查清单（适用于所有系统）

无论你是 Ubuntu / macOS / Windows，卸载后可以做这个「三步自检」：

命令是否已消失
- Linux/macOS：
```
which openclaw
```
- Windows：
```
where openclaw
```
如果命令不存在或者提示 not found，说明 CLI 已卸载。
配置目录是否删除
- Linux/macOS：ls ~/.openclaw
- Windows：检查 %USERPROFILE%\.openclaw
如果目录不存在，说明你已经把工作区/配置删除。
服务/后台进程是否还在运行
- Ubuntu：systemctl list-units | grep openclaw
- macOS：查看是否还有 OpenClaw.app 或你自建的守护进程
- Windows：查看任务管理器 / pm2 列表 / 计划任务