乐于分享
好东西不私藏

OpenClaw 卸载指南:Windows 和 Mac 怎么安全彻底删干净

OpenClaw 卸载指南:Windows 和 Mac 怎么安全彻底删干净

OpenClaw 卸载指南:Windows 和 Mac 怎么安全彻底删干净

如果你准备卸载 OpenClaw,先记住一句话:

不要先删程序本体,要先停服务,再清状态和工作区,最后再删 CLI。

很多人卸载不干净,不是不会删,而是顺序错了。

先看最短答案

如果你的 openclaw 命令还能用,最稳的顺序是:

  1. 先备份你还要保留的工作区
  2. 先执行 openclaw uninstall --dry-run
  3. 再执行 openclaw uninstall 或 openclaw uninstall --all --yes --non-interactive
  4. 最后按安装方式删除 CLI 本体

如果你的 openclaw 命令已经没了,但服务还在跑,就直接跳到后面的“手动移除服务”部分。

先分清楚:普通卸载和彻底卸载的区别

普通卸载

普通卸载会处理这些内容:

  • Gateway 服务
  • 本地状态和配置
  • 工作区

彻底卸载

彻底卸载是在上面的基础上,再处理:

  • CLI 本体
  • macOS App
  • 自定义配置路径
  • 不同 profile 下的额外状态目录

如果你准备重装、换机器,或者以后不再使用 OpenClaw,直接按彻底卸载走。

Windows 卸载流程

如果你是在 Windows 上安装和使用 OpenClaw,按下面这套流程走。

第一步:先确认命令还能不能用

打开 PowerShell,执行:

openclaw --version
  • 有版本号:继续下一步
  • 提示命令不存在:跳到后面的“Windows 手动移除服务”

第二步:先做预演

openclaw uninstall --dry-run

重点看输出里有没有:

  • workspace
  • state
  • service

如果有你不认识的目录,先停一下。

第三步:执行官方卸载

普通卸载:

openclaw uninstall

彻底卸载:

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

第四步:删除 CLI 本体

如果你之前是通过安装脚本装的,大多数情况下执行:

npm rm-g openclaw

如果你用的是 pnpm:

pnpm remove -g openclaw

如果你用的是 bun:

bun remove -g openclaw

第五步:检查默认状态目录

Windows 常见默认目录在:

$env:USERPROFILE\.openclaw

可以检查:

Get-ChildItem"$env:USERPROFILE\.openclaw"

如果目录不存在,或者里面已经没有 OpenClaw 的核心文件,说明清理基本完成。

第六步:如果命令没了,但计划任务还在,手动删除

OpenClaw 在 Windows 上默认使用计划任务。

常见任务名:

  • OpenClaw Gateway
  • OpenClaw Gateway (<profile>)

执行:

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

如果你用了 profile,也要删除对应目录下的 gateway.cmd

第七步:最后检查

检查 CLI:

openclaw --version

检查计划任务:

schtasks /Query | findstr "OpenClaw Gateway"

如果这两步都不再显示 OpenClaw 相关内容,Windows 侧基本就卸干净了。

macOS 卸载流程

如果你是在 Mac 上使用 OpenClaw,按下面这套流程走。

第一步:先确认命令还能不能用

打开 Terminal,执行:

openclaw --version
  • 有版本号:继续下一步
  • 提示命令不存在:跳到后面的“macOS 手动移除服务”

第二步:先做预演

openclaw uninstall --dry-run

看到 workspacestateservice,基本说明卸载目标是对的。

第三步:执行官方卸载

普通卸载:

openclaw uninstall

彻底卸载:

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

第四步:删除 CLI 本体

如果你之前通过安装脚本安装,大多数情况下执行:

npm rm -g openclaw

如果你用的是 pnpm:

pnpm remove -g openclaw

如果你用的是 bun:

bun remove -g openclaw

第五步:如果你装过 Mac App,再删应用本体

rm -rf /Applications/OpenClaw.app

如果你没装过 App,这一步直接跳过。

第六步:检查默认状态目录

默认目录通常是:

~/.openclaw

检查:

ls -la ~/.openclaw

如果目录不存在,或者里面已经没有 OpenClaw 的核心文件,说明状态目录基本已经清掉。

第七步:如果命令没了,但 launchd 服务还在,手动删除

OpenClaw 在 macOS 上默认使用 launchd

常见 label:

  • bot.molt.gateway
  • bot.molt.<profile>
  • 老版本可能还有 com.openclaw.*

执行:

launchctl bootout gui/$UID/bot.molt.gatewayrm -f ~/Library/LaunchAgents/bot.molt.gateway.plist

如果你用了 profile,把名字换成对应 profile 的 label。

第八步:最后检查

检查 CLI:

openclaw --version

检查服务:

launchctl list | grep molt

如果这两步都不再显示 OpenClaw 相关内容,macOS 侧基本就卸干净了。

如果你用过自定义配置或多个 profile

如果你设置过:

  • OPENCLAW_CONFIG_PATH
  • OPENCLAW_STATE_DIR

那配置和状态文件可能不在默认目录。

这时候要把自定义路径下的文件也一起删掉。

如果你启用过多个 profile,也要检查每个 profile 对应的状态目录,不要只删默认目录。

如果你是在 Linux 或 WSL 里跑 OpenClaw

如果你是在 Linux 或者 Windows 的 WSL 环境里运行 OpenClaw,手动移除服务时看这个:

  • 常见 unit 名:openclaw-gateway.service
  • 或 openclaw-gateway-<profile>.service

执行:

systemctl --user disable --now openclaw-gateway.servicerm -f ~/.config/systemd/user/openclaw-gateway.servicesystemctl --user daemon-reload

如果你用了 profile,把服务名换成对应版本。

如果你是从源码目录运行的

如果你是:

  • 自己 git clone
  • 然后在仓库目录里运行 OpenClaw

正确顺序是:

  1. 先卸载 Gateway 服务
  2. 再删除 repo 目录
  3. 最后删除状态目录和 workspace

不要反过来。

最后一轮检查

检查 1:CLI 还在不在

openclaw --version

如果你连 CLI 也要彻底删掉,这里应该提示命令不存在。

检查 2:状态目录还在不在

macOS:

ls -la ~/.openclaw

Windows PowerShell:

Get-ChildItem"$env:USERPROFILE\.openclaw"

检查 3:服务还在不在

macOS:

launchctl list | grep molt

Windows PowerShell:

schtasks /Query | findstr "OpenClaw Gateway"

Linux / WSL:

systemctl --user list-units | grep openclaw

如果这些检查都不再显示 OpenClaw 相关内容,基本就算卸干净了。

最后记住一句话

先确认命令还能不能用,再做 openclaw uninstall --dry-run,再执行官方卸载,最后单独删除 CLI 本体。

这就是普通用户最高效、也最不容易出错的卸载顺序。