不少人装好OpenClaw之后,不管是想要更换软件版本,还是打算不再继续使用,只做普通删除操作,都会碰到文件清理不干净、后台服务无法关闭、命令行依旧可以调用的麻烦,就算反复清理也没法彻底移除。
本篇文章针对Windows、macOS、Linux三大主流系统,外加npm、pnpm两种安装途径,整理了一套无残留的完整卸载办法,不管是图形界面安装还是命令行安装,只要跟着步骤一步步操作,就能完成彻底清理,不会留下配置项、后台服务以及缓存文件。
卸载OpenClaw千万不能只删除主程序,整体要分成三个核心步骤,依次是关闭后台运行服务、卸载主程序与CLI工具、删除本地配置缓存及冗余文件,但凡少做其中一个步骤,就会产生文件残留,甚至还会占用电脑后台进程。
大家可以优先使用官方自带的卸载指令,这种方式操作起来更省事,要是CLI命令无法正常使用,再选择手动清理的方式,两种方法都能实现完全卸载,不会留下任何多余文件。
一、npm 全局安装 OpenClaw 彻底卸载
绝大多数用户都是通过npm完成OpenClaw的全局安装,整个卸载流程都能在终端或者CMD窗口内完成,不需要手动查找文件路径。
1. 官方一键卸载(推荐)
大家可以先运行软件内置的卸载脚本,这个脚本会自动关闭后台服务、清理相关配置文件,全程不需要大家手动干预操作。
openclaw uninstall --all --yes --non-interactive
2. 卸载全局 CLI 工具
接着输入npm专属卸载指令,将系统里的OpenClaw全局调用命令彻底移除。
npm uninstall -g openclaw
3. 删除本地残留文件
最后把配置、缓存、工作区三类文件夹全部删除,这一步是杜绝文件残留的关键环节,一定要执行到位。
# Windows 系统(PowerShell 执行)
Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw
# macOS/Linux 系统
rm -rf ~/.openclaw
二、pnpm 全局安装 OpenClaw 彻底卸载
通过pnpm安装的OpenClaw,卸载流程和npm安装的基本一致,仅仅只是指令存在细微差别,依旧按照先关闭服务、再删除工具、最后清理残留的顺序操作即可。
1. 官方一键卸载
openclaw uninstall --all --yes --non-interactive
2. 卸载全局 CLI 工具
pnpm remove -g openclaw
3. 删除本地残留文件
这一步执行的指令和npm卸载完全相同,大家选择对应系统的指令运行,就能清空用户目录下所有和OpenClaw相关的文件。
三、Windows 系统完整卸载(图形+命令双方案)
Windows系统除了包管理器安装的方式,还有独立的桌面客户端,同时还会自动创建系统计划任务,卸载的核心重点就是关闭后台服务、删除对应的计划任务。
方案一:CLI 可用时一键卸载
打开PowerShell窗口,建议大家使用管理员权限运行,先执行官方卸载指令,再一步步清理本地残留文件。
openclaw uninstall --all --yes --non-interactive
npm uninstall -g openclaw
# 若为 pnpm 安装替换为 pnpm remove -g openclaw
Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw
方案二:CLI 失效,手动彻底卸载
第一步先关闭并且删除OpenClaw的系统计划任务,从根源上解决后台自启残留的问题。
schtasks /Delete /F /TN "OpenClaw Gateway"
第二步直接删除对应的任务脚本文件,避免残留脚本占用系统资源。
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"
第三步卸载全局CLI工具,大家根据自己当初的安装方式,运行对应的卸载指令即可。
第四步手动删除本地配置文件夹,文件路径为C:\Users\你的用户名\.openclaw,直接右键选择彻底删除就行。
第五步如果安装了桌面客户端,可以打开控制面板找到程序和功能板块,选中OpenClaw完成卸载,也可以直接删除桌面快捷方式和根目录安装文件夹。
四、macOS 系统完整卸载
在macOS系统中,OpenClaw会自动开启后台守护服务,卸载的时候必须先关闭这项服务,再删除程序和本地文件,防止服务一直在后台持续运行。
方案一:CLI 可用时一键卸载
openclaw uninstall --all --yes --non-interactive
# npm 安装执行
npm uninstall -g openclaw
# pnpm 安装执行
pnpm remove -g openclaw
rm -rf ~/.openclaw
方案二:CLI 失效,手动彻底卸载
第一步先关闭并且移除后台网关服务,终止后台常驻进程。
launchctl bootout gui/$UID/ai.openclaw.gateway
第二步删除服务对应的配置文件,清理系统内的服务配置残留。
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist
第三步卸载全局CLI工具,清空系统全局命令。
第四步删除本地配置与缓存文件,彻底清理用户目录下的冗余数据。
若是安装了桌面端应用,直接删除应用程序目录内的OpenClaw.app。
第五步如果安装了桌面端应用,直接删除应用程序文件夹内的OpenClaw.app安装包即可。
rm -rf /Applications/OpenClaw.app
五、Linux 系统完整卸载
Linux系统大多采用命令行方式安装OpenClaw,依靠systemd工具管理后台服务,卸载的核心步骤就是先禁用并删除相关服务,再清理本地残留文件。
方案一:CLI 可用时一键卸载
openclaw uninstall --all --yes --non-interactive
# npm 安装执行
npm uninstall -g openclaw
# pnpm 安装执行
pnpm remove -g openclaw
rm -rf ~/.openclaw
方案二:CLI 失效,手动彻底卸载
第一步先关闭并且禁用OpenClaw后台服务,停止进程运行。
systemctl --user disable --now openclaw-gateway.service
第二步删除服务配置文件,再重新加载systemd工具,完成服务配置刷新。
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload
第三步卸载全局CLI工具,移除系统全局调用命令。
第四步彻底删除配置、缓存、工作区相关文件,实现全量清理。
rm -rf ~/.openclaw
卸载后验证:确认完全清理
完成所有卸载步骤之后,在终端或者CMD窗口输入下方指令,要是页面提示“命令不存在”,同时系统内的.openclaw文件夹也已删除,就代表软件已经卸载干净。
openclaw --version
如果依旧能查询到软件版本信息,说明全局安装包没有清理彻底,重新运行对应包管理器的卸载指令就能解决。
常见问题补充
第一点如果使用了--profile多配置文件,也要同步删除~/.openclaw-配置名文件夹,并且清理对应的关联服务。
第二点Windows系统如果找不到计划任务,可以直接打开任务计划程序,手动查找OpenClaw相关任务并完成删除。
第三点如果是源码安装的OpenClaw,除了上述所有步骤,还要手动删除git clone下载的源码根目录文件夹。
以上就是全平台OpenClaw彻底卸载的完整方法,全程做到无残留清理,新手也能轻松上手操作,再也不用为软件残留清理不干净的问题发愁。