- 发表时间: 2026-04-02
- 浏览次数: 113
方法一:官方推荐卸载(最简单,适合新手)
如果你的OpenClaw CLI还能正常使用(就是终端输入openclaw能有反应),先试试官方自带的卸载命令,省点事,虽然不能彻底清干净,但能删掉大部分核心组件。
打开终端,直接输入下面这行命令,按回车即可:
openclaw uninstall
如果想让它自动卸载,不用手动确认,就输入这个(懒人首选):
openclaw uninstall --all --yes --non-interactive
这个命令会自动删掉这些东西,不用你一个个操作:
Gateway 服务(后台运行的核心)
CLI 程序(终端里的命令)
配置文件和工作目录
Mac上的OpenClaw应用(/Applications里的图标)
相关的Docker容器(如果之前用Docker运行过)
执行完之后,你会发现大部分OpenClaw相关的东西都没了,但很多人会遇到这3个问题,这就说明还有残留,需要手动清理:
打开终端,自动弹出OpenClaw相关提示,或者自动运行
输入openclaw提示“command not found”,但后台还有OpenClaw进程
Node shim自动重建,删了又出现
别慌,接下来的手动卸载步骤,就能解决这些问题,建议大家不管官方卸载有没有成功,都跟着走一遍,彻底清干净!
二、手动卸载(推荐彻底执行,告别残留)
手动卸载一共5步,每一步都很简单,跟着输命令、按回车就好,全程不用懂复杂的技术,新手也能轻松上手,建议一步步来,不要跳步。
1. 先停止OpenClaw后台服务(关键第一步)
不管你有没有用官方命令卸载,先把后台正在运行的OpenClaw服务停掉,不然后续删文件会提示“无法删除,文件正在使用”。
如果CLI还能使用,输入这行命令:
openclaw gateway stop
如果已经提示“command not found”(CLI被删了),就用Mac自带的命令停止服务,输入:
launchctl bootout gui/$UID/ai.openclaw.gateway
输完按回车,没有报错就说明服务停成功了。
2. 删除launchd自启动服务(避免开机自动启动)
OpenClaw之所以会开机自动启动、终端一打开就运行,核心就是这个launchd自启动服务在搞鬼,必须删掉它的配置文件。
终端输入下面这行命令,删除plist文件(自启动配置文件):
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist
提醒一下:如果之前用OpenClaw创建过profile(配置文件),可能会有类似“ai.openclaw.<profile>”这样的文件,也一起删掉,避免残留。
3. 删除配置与数据目录(彻底清空缓存和数据)
OpenClaw的配置文件、运行缓存、工作区数据,都存在~/.openclaw这个目录里,就算删了应用,这个目录还在,占空间还可能导致残留,必须彻底删掉。
输入这行命令,删除默认配置目录:
rm -rf ~/.openclaw
如果之前用过多重profile,就再输入这行,删除所有相关目录:
rm -rf ~/.openclaw-*
最后再清理一下工作区(里面都是运行产生的临时数据),输入:
rm -rf ~/.openclaw/workspace
4. 删除CLI程序(终端里的openclaw命令)
这一步要看你当初是用什么工具安装的OpenClaw(npm/pnpm/bun),对应输入命令即可,三种都输一遍也没关系,不会报错。
如果是用npm安装的,输入:
npm rm -g openclaw
如果是用pnpm安装的,输入:
pnpm remove -g openclaw
如果是用bun安装的,输入:
bun remove -g openclaw
5. 删除Mac应用(桌面上/启动台里的图标)
如果当初安装了OpenClaw的GUI应用(就是能在启动台里找到的图标),输入这行命令删除,比手动拖到废纸篓更彻底:
rm -rf /Applications/OpenClaw.app
到这里,手动卸载的核心步骤就完成了,但还有两个最容易被忽略的残留——shell自动加载和Node shim,这俩不删,还是会出现“自动启动”的问题,继续往下走!
三、清理shell自动启动(最容易被忽略,重点!)
很多人卸载完,打开终端还是会自动运行OpenClaw,问题就出在shell的自动加载里——当初安装OpenClaw时,它的脚本自动在你的.zshrc(或.bashrc)文件里加了一行代码,每次打开终端都会自动执行。
第一步:打开配置文件,终端输入:
nano ~/.zshrc
(如果你的终端用的是bash,就输入nano ~/.bashrc)
第二步:在打开的文件里,找到类似这样的一行代码(可能不是完全一样,但包含openclaw):
source <(openclaw completion ...)
找到后,按键盘上的“Ctrl+K”删除这一行,然后按“Ctrl+O”保存,按“Ctrl+X”退出。
第三步:刷新shell,让修改生效,输入:
source ~/.zshrc
这一步一定要做!不然就算删了代码,下次打开终端还是会自动加载,等于白删。
四、清理Node shim(顽固残留,删不干净就看这里)
如果你用了nodenv、nvm、asdf这些Node版本管理器,安装OpenClaw时会生成一个“shim”文件,就算删了全局包,这个shim还在,会自动重建openclaw命令,导致删不干净。
第一步:删除shim文件,终端输入:
rm -f ~/.nodenv/versions/*/bin/openclaw
第二步:重新生成Node的shim缓存,避免它重新创建openclaw,输入:
nodenv rehash
这样一来,顽固的Node shim残留就彻底清干净了,不会再自动重建。
五、检查:确认系统已经彻底卸载(必做!)
清理完之后,别着急关掉终端,用3个简单的命令,检查一下是不是真的彻底删干净了,避免有遗漏。
1. 检查CLI是否删除
输入命令:
which openclaw
如果返回“openclaw not found”,说明CLI已经彻底删除了。
2. 检查后台服务是否残留
输入命令:
launchctl list | grep openclaw
如果没有任何输出,说明后台服务已经彻底停掉、删除干净了。
3. 检查配置目录是否残留
输入命令:
ls -a ~ | grep openclaw
如果没有出现任何带“openclaw”的目录,说明配置文件也删干净了。
三个命令都符合要求,就说明OpenClaw已经彻底从你的Mac上消失了!
六、一键彻底卸载脚本(进阶,懒人福音)
如果觉得一步步输命令太麻烦,给大家准备了一个一键清理脚本,复制粘贴保存,运行一次就能完成所有清理步骤,适合有一点点终端基础的朋友(新手也能操作,跟着来就好)。
第一步:打开终端,输入命令创建脚本文件:
nano remove-openclaw.sh
第二步:将下面的脚本代码,全部复制粘贴到打开的文件里(不要漏任何一行):
#!/usr/bin/env zshlaunchctl bootout gui/$UID/ai.openclaw.gateway 2>/dev/nullrm -rf ~/.openclawrm -rf ~/.openclaw-*rm -rf ~/Library/LaunchAgents/ai.openclaw*npm rm -g openclaw 2>/dev/nullpnpm remove -g openclaw 2>/dev/nullbun remove -g openclaw 2>/dev/nullrm -rf /Applications/OpenClaw.apprm -f ~/.nodenv/versions/*/bin/openclawecho "OpenClaw removed."
第三步:按“Ctrl+O”保存,按“Ctrl+X”退出。
第四步:运行脚本,输入命令:
bash remove-openclaw.sh
等待几秒,出现“OpenClaw removed.”的提示,就说明一键清理完成了,之后再用上面的3个检查命令,确认一下就好。
七、常见卸载问题(踩坑必看,解决你遇到的麻烦)
很多人在卸载过程中会遇到一些小问题,这里整理了3个最常见的,给出具体解决方法,不用再到处查教程。
1. 终端仍然提示Node版本错误
大概率是前面说的“shell自动加载”没清理干净,就是.zshrc(或.bashrc)里的那行openclaw相关代码没删。
解决方法:重新按照“第四步”的步骤,打开配置文件,删除相关代码,再刷新shell即可。
2. 输入openclaw,命令仍然存在
说明CLI程序没删干净,可能是安装路径不是默认的,大概率藏在/usr/local/bin/openclaw里。
解决方法:输入命令删除:
rm /usr/local/bin/openclaw
3. 每次开机,OpenClaw仍然自动启动
说明launchd自启动服务没删干净,可能是plist文件没删全,或者有其他profile相关的文件。
解决方法:重新输入命令删除所有相关plist文件:
rm -f ~/Library/LaunchAgents/ai.openclaw*
删除后重启电脑,就不会再自动启动了。
八、彻底卸载后的系统状态(放心确认)
彻底清理完成后,你的Mac里不应该再存在这些东西:
openclaw相关命令(终端输入which openclaw提示不存在)
~/.openclaw及相关目录
~/Library/LaunchAgents/ai.openclaw* 相关文件
/Applications/OpenClaw.app 应用
此时,你的Mac就完全恢复到了没安装过OpenClaw的状态,没有任何残留,不会再出现自动启动、进程残留的问题,也不会占用多余的存储空间。



