乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > OpenClaw 想卸载干净?一篇讲明白:Mac / Linux / Windows 全平台指南

OpenClaw 想卸载干净?一篇讲明白:Mac / Linux / Windows 全平台指南

当前时间： 2026-03-12 04:52:51 分类：办公文件 评论(0)
OpenClaw 想卸载干净?一篇讲明白:Mac / Linux / Windows 全平台指南

最近不少人在折腾 OpenClaw，本地部署、云端运行、插件接入、模型授权，玩得很热闹。

但装上去容易，卸载干净这件事，很多人反而会卡住：

  • 命令删了，但服务还在后台跑
  • 配置文件没清，重装后继续读旧配置
  • Mac / Linux / Windows 的后台服务机制不一样，不知道该删哪一层
  • 用了 profile、多环境，删了一个，另一个还在

OpenClaw 官方其实已经给了完整卸载说明，而且分得很细：
如果 CLI 还在，用官方卸载命令最省事；如果 CLI 已经不在了，但后台服务还活着，就需要手动按系统清理。

一、先说结论：OpenClaw 卸载有两种路径

OpenClaw 官方把卸载分成两种情况：

第一种：CLI 还在
也就是你还能正常执行 openclaw 命令，这种最简单，直接用官方内置卸载器。

第二种：CLI 没了，但服务还在跑
这种常见于你删了命令、删了目录，结果后台网关服务还在自启动。这时就要按 macOS、Linux、Windows 的服务方式手动清理。

二、最推荐的卸载方式：直接用官方命令

如果你机器上 openclaw 命令还在，官方推荐直接执行：

openclaw uninstall

这是最省事的做法。官方也提供了适合自动化场景的非交互命令：

openclaw uninstall --all --yes --non-interactive

如果你是通过 npx 调用，也可以这样：

npx -y openclaw uninstall --all --yes --non-interactive

三、手动卸载

1）先停止 gateway 服务

openclaw gateway stop

这一步的目的是先把后台运行的 OpenClaw 网关停掉。

2）卸载 gateway 服务

openclaw gateway uninstall

这一条会把系统里的服务注册卸掉。不同系统底层机制不同，可能对应的是：

  • macOS 的 launchd
  • Linux 的 systemd user unit
  • Windows 的计划任务（Scheduled Task）

3）删除状态目录和配置

rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"

这里删的是 OpenClaw 的状态目录。默认路径通常是 ~/.openclaw。
如果你设置过 OPENCLAW_CONFIG_PATH，并且它指向的是状态目录之外的自定义配置文件，那这个文件也要手动删掉。

4）删除 workspace（可选）

rm -rf ~/.openclaw/workspace

这一步是可选的，主要用于删除 agent 相关文件和工作区内容。
如果你想彻底清掉 OpenClaw 留下的工作目录，建议也一起删。

5）移除 CLI 安装

看你当初是怎么安装的，就卸载对应的全局包：

npm rm -g openclaw
pnpm remove -g openclaw
bun remove -g openclaw

官方文档说明，如果你是通过 install.sh 或 install.ps1 安装，本质上 CLI 一般也是通过全局包安装的，所以这一步别漏。

6）如果装过 macOS App，也要删应用本体

rm -rf /Applications/OpenClaw.app

也就是说，CLI 卸载 ≠ App 卸载。
如果你 Mac 上还装过 OpenClaw 图形应用，记得把 /Applications/OpenClaw.app 也清掉。

四、最容易漏掉的坑：Profile、多环境、远程模式

1）如果你用了 profile，不止一个目录

如果你启动时用了 --profile，或者配置了 OPENCLAW_PROFILE，那么状态目录不一定只有默认的 ~/.openclaw。

官方默认命名方式是：

~/.openclaw-

所以你可能删了默认目录，但其他 profile 目录还在。重装之后看起来像“卸载没成功”，其实是旧 profile 还被读到了。

2）如果你是 remote mode，要去网关主机上删

远程模式下，状态目录是在 gateway 主机上。

也就是说，你在本地删一遍不够，真正的状态、服务、工作目录，可能还在远程服务器上。
这时官方建议把前面的停止、卸载、删除目录这些步骤，也在 gateway 主机上执行一遍。

五、如果 CLI 已经没了，但 OpenClaw 还在后台运行，怎么办？

这就是第二条路径：手动移除服务。官方把三大系统分别写了。

六、macOS 手动卸载方式

在 macOS 上，OpenClaw 默认使用的是 launchd。
官方给出的默认服务标签是：

ai.openclaw.gateway

如果你用了 profile，可能会变成：

ai.openclaw.

此外，官方还提醒：旧版本遗留的 com.openclaw.* 也可能还在。

官方命令如下：

launchctl bootout gui/$UID/ai.openclaw.gateway
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist

如果你用了 profile，就把服务名和 plist 名里的 gateway 替换成对应 profile。
如果你机器上还留着旧版 com.openclaw.* 的 plist，也建议顺手一并清理。

七、Linux 手动卸载方式

Linux 下默认是 systemd user unit。
默认服务名是：

openclaw-gateway.service

如果用了 profile，则会变成：

openclaw-gateway-.service

官方给出的手动清理命令是：

systemctl --user disable --now openclaw-gateway.service
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload

这三步分别对应：

  1. 停止并禁用服务
  2. 删除 unit 文件
  3. 重新加载 systemd 配置

如果你是多 profile，也记得把对应 profile 的 service 文件一起删掉。

八、Windows 手动卸载方式

Windows 下，OpenClaw 默认使用的是计划任务。
官方写得很明确：默认任务名是：

OpenClaw Gateway

如果用了 profile，则可能显示为：

OpenClaw Gateway (<profile>)

对应的任务脚本一般会放在状态目录下面。

官方给出的删除命令是：

schtasks /Delete /F /TN "OpenClaw Gateway"
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"

如果你用了 profile，就把计划任务名称和路径里的目录一起替换掉，例如：

$env:USERPROFILE\.openclaw-<profile>\gateway.cmd

这样才算删干净。

九、普通安装和源码运行，卸载逻辑也不一样

这个点官方也单独说明了。

普通安装

如果你是通过这些方式装的：

  • install.sh
  • install.ps1
  • npm
  • pnpm
  • bun

那 CLI 一般就是全局安装的 openclaw 包，所以卸载时需要执行全局包移除命令。

源码运行

如果你是：

git clone ...

然后在源码目录里运行 openclaw ... 或 bun run openclaw ...

那官方建议顺序是：

  1. 先卸载 gateway 服务
  2. 再删除源码仓库目录
  3. 最后删除 state 和 workspace

这个顺序很重要。
因为如果你先删仓库，再删服务，可能会遇到“服务残留、启动入口找不到、但系统还记着要启动它”的情况。

十、我建议大家这样理解：OpenClaw 卸载其实要删 4 层

你可以把 OpenClaw 想成四层结构：

第 1 层：CLI 命令本体

就是你平时敲的 openclaw

第 2 层：后台 gateway 服务

它可能注册在：

  • macOS launchd
  • Linux systemd
  • Windows 计划任务

第 3 层：状态目录 / 配置目录

例如：

~/.openclaw
~/.openclaw-

第 4 层：workspace / agent 文件

例如：

~/.openclaw/workspace

很多人以为“删了命令就算卸载”，其实只是删了第一层。
真正要做到“重装像新装一样干净”，至少要把服务 + 状态目录也处理掉。这个逻辑和官方文档是一致的。

十一、给普通用户的最省事方案

如果你只是想“赶紧卸载干净，别留坑”，我建议直接按这个顺序来：

Mac / Linux / Windows 通用优先方案

openclaw uninstall

如果你还想更彻底、适合自动化：

openclaw uninstall --all --yes --non-interactive

然后再检查一下：

  • ~/.openclaw
  • ~/.openclaw-<profile>
  • ~/.openclaw/workspace
  • 有没有对应系统服务残留
  • Mac 是否还有 /Applications/OpenClaw.app

十二、最后总结一句

OpenClaw 的官方卸载逻辑其实不复杂，核心就一句话：

先卸服务，再删状态，再删 CLI。

如果 CLI 还在，直接：

openclaw uninstall

如果 CLI 不在了，就按你的系统去删后台服务：

  • macOS：删 launchd
  • Linux：删 systemd user unit
  • Windows：删计划任务

再把 ~/.openclaw、workspace、profile 目录一起清掉，才算真正“卸载干净”。