1. 卸载前先搞清楚OpenClaw到底装到了哪里先说核心结论OpenClaw作为一个基于Node.js生态的大模型应用框架它的卸载逻辑和传统桌面软件完全不同。传统软件装完后在“控制面板-添加删除程序”里点一下就完事但OpenClaw这种通过命令行、脚本或Docker部署的AI智能体框架安装时会往系统里塞进好几个部分程序本体、全局命令、配置文件、数据目录、可能还有开机自启的服务。只删掉其中一块过几天你会发现它又在后台偷偷运行了。我见过不少在新手在卸载OpenClaw时犯的一个典型错误打开项目目录发现有个文件夹叫openclaw右键删除然后觉得卸载完了。结果一打开终端敲openclaw命令照样能执行。这就是因为全局命令还链接着PATH环境变量里也残留着旧路径。所以卸载OpenClaw的正确姿势第一步不是删文件而是搞清楚这个Agent框架的部署形态。根据你当初安装方式的不同OpenClaw通常会以三种形态之一出现在系统里npm全局包安装如果你在终端执行过npm install -g openclaw/openclaw或类似的全局安装命令那么它会作为一个全局Node模块存在。可以通过npm ls -g查到具体位置Windows上一般在%APPDATA%\npm\node_modules下Linux则多在/usr/lib/node_modules或/usr/local/lib/node_modules。git clone 本地启动很多人按照网上的教程会把项目源码clone到本地比如git clone https://github.com/xxx/openclaw.git然后再手动配置token、启动服务。这种情况下并没有全局命令而是在项目目录下通过node或npm start运行。你的卸载对象主要就是这个文件夹以及散落在用户目录下的配置。Docker容器部署如果你用了官方提供的一键部署Docker方案OpenClaw会跑在一个容器里通过映射端口对外提供服务。卸载需要操作镜像、容器、挂载卷三样东西。每个平台的工具链还不一样Windows上用PowerShell和任务管理器Linux上则是systemd、ps、crontab这些。下面我会按平台拆开讲但请你先照这个方法自查一下打开终端分别执行openclaw --version、npm ls -g | findstr openclawWindows或npm ls -g | grep openclawLinux、docker ps -a | grep openclaw看看装的是哪一种。这三种命令的输出能让你在一分钟内判断出自己当初是怎么装的后面的卸载路径也就清楚了。注意如果你当初是通过“一键部署脚本”安装的这种脚本通常会自动帮你注册systemd服务Linux或计划任务Windows卸载时只删目录会留下自启动残骸。判断方法重启一次系统然后打开终端敲openclaw或者查进程列表如果服务自动起来了说明一定有自启项没有清掉。还有一个容易漏的地方OpenClaw这类大模型Agent框架往往会内置浏览器自动化插件比如Playwright/Puppeteer相关组件卸载npm包不会自动删除浏览器内核和缓存目录。Windows下它们躺在%LOCALAPPDATA%\ms-playwrightLinux下则是~/.cache/ms-playwright。普通人卸载后硬盘多出几个G的残留基本都是这玩意儿。后面我会给清理方案。2. Windows平台卸载OpenClaw的完整实操2.1 第一步停掉进程和后台服务否则锁文件会让你崩溃在Windows上卸载OpenClaw遇到的第一个拦路虎往往不是权限而是进程占用。如果你当初启用了openclaw serve这种常驻服务模式那么就算关掉了终端窗口后台可能还挂着Node进程。Windows下如果直接删除文件会碰上一堆“文件正在被另一个进程使用”的报错网上搜到的那个报错信息agent failed before reply: session file locked (timeout 60000ms)本质上就是Node把session文件锁定住了。正确的停进程方式不是去任务管理器里翻而是用管理员权限打开PowerShell执行# 先找到OpenClaw相关的进程 tasklist | findstr /i openclaw tasklist | findstr /i node # 找到结束后按PID精确结束 taskkill /F /PID 12345 # 如果它跑在服务里还需要停服务 Get-Service -Name *openclaw* | Stop-Service -Force sc.exe delete OpenClawService这里我想特别说明为什么不要直接taskkill /F /IM node.exe一股脑把所有Node进程杀掉你这台机器上很可能还跑着其他基于Node的工具比如某个本地开发服务器、某个编辑器插件全杀掉会造成连带伤害。我自己的习惯是先tasklist | findstr node观察一下哪些进程的命令行里带openclaw关键字再精准狙击。另一个隐蔽的位置是Windows任务计划程序。一键部署脚本有时会把“开机自动启动OpenClaw”做成一个计划任务。你光停进程是没用的重启后又活了。检查方法schtasks /query | findstr /i openclaw # 如果找到删除它 schtasks /delete /TN OpenClawAutoStart /F2.2 第二步按安装方式分别卸载确认进程都停了之后回到安装方式的判断上三选一如果你用的是npm全局安装在管理员PowerShell里执行npm uninstall -g openclaw/openclaw注意npm卸载只会移除node_modules下的包文件和bin链接但不会清理配置文件。所以执行完以后还得到用户目录下手动删。常见的配置路径有C:\Users\你的用户名\.openclaw\C:\Users\你的用户名\.config\openclaw\C:\Users\你的用户名\.claw\如果环境变量里设置了OPENCLAW_HOME之类的自定义位置那配置文件就会在对应路径下可以用echo %OPENCLAW_HOME%查一下。如果你是git clone 或下载压缩包方式安装的那就更直接找到源码目录直接ShiftDelete删除即可。但删除前务必先把上面的配置目录删掉不然下次重新clone依然会读取到旧配置。如果你是Docker部署的不要直接去Docker Desktop里删容器正确顺序是# 停掉并移除容器 docker stop openclaw-container docker rm openclaw-container # 删除挂载卷注意卷名以实际docker volume ls为准 docker volume ls | findstr openclaw docker volume rm openclaw_config # 最后删镜像 docker rmi openclaw-image为什么强调先删卷再删镜像因为Docker镜像本身只是一个只读模板配置和数据都在卷里如果把配置丢了但镜像还在你重新run一条命令就全部复现了。如果先删镜像但卷还在那下次运行同版本镜像时还会载入旧配置。两样都要清才叫卸载干净。2.3 第三步清理PATH环境变量和残留配置npm全局包卸载后npm会自动尝试清理bin链接但有时候因为路径带空格、权限异常等原因系统PATH里的C:\Users\用户名\AppData\Roaming\npm并不会自动移除 —— 这个路径本身是npm全局bin的公共路径一般不建议删掉整条但可以检查一下有没有单独指向openclaw自定义bin的条目。具体做法右键“此电脑” → 属性 → 高级系统设置 → 环境变量在“用户变量”和“系统变量”的Path里翻一遍凡是形如C:\Users\用户名\AppData\Roaming\npm\node_modules\openclaw...这样的条目直接删除。然后是隐藏残留。OpenClaw在Windows下会用%LOCALAPPDATA%存储一些运行时缓存做得隐蔽一点的文件在C:\Users\用户名\AppData\Local\openclaw和C:\Users\用户名\AppData\Local\Temp\openclaw*。特别是Date目录下的数据文件如果卸载不彻底你下次重装后会看到历史会话自动同步出来——对隐私敏感的人来说这个非常要命。稳妥做法是把下面几个位置都扫一遍$paths ( $env:APPDATA\openclaw, $env:APPDATA\npm\node_modules\openclaw, $env:LOCALAPPDATA\openclaw, $env:LOCALAPPDATA\ms-playwright, $env:USERPROFILE\.openclaw, $env:USERPROFILE\.claw ) foreach ($p in $paths) { if (Test-Path $p) { Write-Host 发现残留目录: $p ($((Get-Item $p).Length 字节约)) } }浏览器自动化内核那一项如果你之前用的OpenClaw版本强制依赖Playwright浏览器就会在ms-playwright目录下缓存Chromium。这个文件夹可能有几百MB到1GB多删不删取决于你是否还需要其他Playwright项目。如果确认不需要直接右键删除即可。2.4 Windows下容易忽略的三个坑第一个坑是安全软件拦截。Windows Defender有时候会把OpenClaw的自动化脚本识别为可疑程序卸载过程中如果有文件删不掉十有八九是Defender正在后台扫描。你可以先临时关一下实时防护卸载完再打开。第二个坑是WSL和Windows双环境。很多教程会让你在Windows自带的Linux子系统WSL里装OpenClaw。如果是这种部署你在Windows桌面侧怎么删都没用得进WSL环境里去卸载。思路和Linux完全一致直接跳到下一节看。第三个坑是环境变量里的NODE_OPTIONS。有些部署脚本为了讲OpenClaw连上大模型API会往系统环境变量里塞NODE_OPTIONS--max-old-space-size4096。卸载OpenClaw后这个变量如果还留着会影响其他Node项目的运行内存分配。检查方法环境变量面板搜NODE_OPTIONS如果是单独为OpenClaw设置的记得一并删除。3. Linux平台卸载OpenClaw的完整实操3.1 第一步识别并停用systemd服务Linux上的OpenClaw部署比Windows更常见也更隐蔽。很多一键脚本装完后会以systemd服务的形式托管即使你关机重启它也会自动拉起。这是Linux上卸载OpenClaw最关键的环节。我一贯的建议是先别急着删文件用下面一组命令把“服务层”的东西翻个底朝天# 查找所有带 openclaw 字样的服务 systemctl list-unit-files | grep -i openclaw # 如果有服务单元比如 openclaw.service执行停止禁用 sudo systemctl stop openclaw.service sudo systemctl disable openclaw.service # 删除服务单元文件 sudo rm /etc/systemd/system/openclaw.service sudo systemctl daemon-reload这里disable和stop是两码事。stop只针对当前运行状态disable才是确保下次开机不再自启。很多过来人只跑了stop重启后服务又活了然后怀疑自己是不是卸载了个寂寞。daemon-reload也别忘了跑它让systemd重新扫描单元文件否则旧配置还会留在内存缓存里。还有一种情况是有人用supervisor或pm2来托管OpenClaw进程常见于生产环境。如果是pm2托管的需要pm2 list | grep openclaw pm2 delete openclaw-app pm2 savepm2有个坑pm2 delete只是删掉当前守护进程列表如果你没有执行pm2 save重启pm2后它可能根据旧的dump文件重新拉起。所以pm2 delete和pm2 save必须连着执行。3.2 第二步区分三种安装方式并逐个清理Linux下卸载OpenClaw一定要先判断它是npm包、源码还是Docker。判断命令which openclaw npm ls -g | grep -i openclaw docker ps -a | grep -i openclaw如果是npm全局包卸载命令和Windows大同小异npm uninstall -g openclaw/openclaw但这里有个Linux特有的细节npm全局包的bin符号链接位于/usr/local/bin或/usr/bin卸载后如果链接没删干净shell的hash缓存还会“记住”旧路径。执行完卸载后建议跑一下hash -r刷新一下命令缓存否则你在同一个终端会话里敲openclaw还是会报“命令已找到但无法执行”的诡异错误。如果是git clone 源码部署直接递归删除目录并清理用户级配置rm -rf ~/openclaw rm -rf ~/.openclaw rm -rf ~/.config/openclaw rm -rf ~/.local/share/openclaw如果是Docker 部署按顺序清理容器、卷、镜像docker ps -a | grep openclaw docker stop 容器名或ID docker rm 容器名或ID docker volume ls | grep openclaw docker volume rm 卷名 docker images | grep openclaw docker rmi 镜像ID提示Linux下Docker卷一旦删除不可恢复。如果你因为调试问题卸载OpenClaw打算过阵子再装回来建议在卸载前先用docker cp把卷里的配置备份到宿主机等重装时再拷回去。我经历过一次删卷后找不到会话记录的事后来学乖了——凡是容器类应用卸载前一律先备份。3.3 第三步清理crontab、日志和残留库文件Linux部署中最容易被忽略的残留是两个地方定时任务和日志轮转配置文件。OpenClaw社区里有些方案为了保持Agent的长活会建议你往crontab里塞一条定时重启或自检的命令。卸载时这条cron不会自动消失。检查并清理crontab -l | grep -i openclaw # 如果存在编辑删除 crontab -e日志文件的位置一键脚本一般会写在/var/log/openclaw/但也不排除写到~/.openclaw/logs。虽然日志不参与运行但包含大量会话内容涉及数据隐私最好一并清掉。别忘了还有临时目录/tmp/openclaw-*。此外很多Linux一键部署OpenClaw的脚本会顺手安装一个pm2-logrotate模块或者创建/etc/logrotate.d/openclaw配置。找到后同样删除sudo rm /etc/logrotate.d/openclaw还有一个很多人踩的坑次版本残留。Node版本升级后~/.npm/_cacache里可能有OpenClaw相关的缓存包非常占空间。执行一次npm缓存清理npm cache clean --force这条命令会把整个npm缓存清空听起来很暴力但如果这台机器今后还要开发其他Node项目其实清空后重新拉取就行只是在慢网络上首次安装时稍微慢一点。如果你很介意也可以只删除~/.npm/_cacache里带openclaw字母的目录不过操作起来比较麻烦我一般图省事直接全清。3.4 Linux下容易忽略的三个坑第一个坑是NVM安装的Node全局包。如果你用的是nvm管理多个Node版本那么npm uninstall -g只是卸载了当前激活版本的全局包。其他Node版本下的全局包还藏着呢。切换版本后用which openclaw再确认一遍确保每个版本里都卸干净了。第二个坑是Shell启动脚本里的残留别名。有些用户在.bashrc或.zshrc里加过alias openclawnode ~/openclaw/index.js这类快捷命令。卸载时不查shell配置下次打开终端依然能呼起命令还会误以为卸载失败。检查一下~/.bashrc、~/.zshrc、~/.profile把相关行删掉并source一下即可。第三个坑是Docker容器外的端口转发。如果你用docker run -p 3000:3000配合iptables暴露过端口卸载容器后iptables规则一般会被Docker自动清理但如果你手动加过Nginx反向代理配置比如/etc/nginx/conf.d/openclaw.conf卸载容器后Nginx还在那个反代配置会一直报502。记得一并删配置并nginx -s reload。4. 卸载常见问题与排查技巧4.1 报错“session file locked”怎么办这个报错在搜索热词里出现了对应的报错原文是agent failed before reply: session file locked (timeout 60000ms)。它不只在运行时出现卸载时也可能会碰到——表现形式是文件删不掉提示被占用。这背后的原理是OpenClaw会把会话状态写入一个JSON文件并通过文件锁机制防止多个进程同时写入。如果进程异常退出锁文件可能残留。卸载前最安全的做法是先把所有相关进程结束掉前面章节的停进程步骤然后再删除整个会话目录。如果进程已经结束了但锁文件还在Windows下直接强删rm -Force $env:USERPROFILE\.openclaw\sessions\*Linux下rm -f ~/.openclaw/sessions/*.lock你甚至可以不用纠结是哪个文件锁直接把.openclaw整个目录删掉一了百了。4.2 卸载后端口仍然被占用怎么办卸载完OpenClaw后你用netstat -ano | findstr 3000Windows或ss -tlnp | grep 3000Linux发现端口依然被监听。最常见的可能性是你只停了一个进程但OpenClaw的某些辅助服务还在跑——比如内置的浏览器自动化服务、WebSocket通知服务等。Windows下用netstat -ano | findstr :端口号查出PID然后tasklist /FI PID eq PID号确认进程名再结束。Linux下则要留意Python和Node都是可能的宿主不能只想着找openclaw字样的进程名因为Linux进程名截断问题你ps看到的名字可能只是node或python要看它的完整启动命令行ps aux | grep -v grep、/proc/PID/cmdline来确认关联。4.3 卸载后命令仍然可执行的三个排查方向如果你执行完上述所有步骤终端里敲openclaw还能呼起帮助信息逃不出以下几种情况全局alias或shell函数还留着。检查.bashrc、.zshrc、.bash_profile里的alias。NVM多版本下的全局包。切换Node版本再卸载一次。npm缓存中的“幽灵包”。某些npm版本在卸载失败时会在node_modules/.bin下留下空链接。直接查看/usr/local/bin/openclaw或/usr/bin/openclaw是否指向一个不存在的路径如果是手动rm删除。我遇到过一次最离奇的用户用一个带空格的目录名安装了OpenClawnpm卸载时因为路径解析问题没有删掉bin链接。最后手动删掉了/usr/local/bin/openclaw对应的符号链接才彻底解决。因为这种边缘情况我的建议永远是最后执行一条验证which openclaw只要它返回一个路径你就要继续追查那个路径是从哪来的。4.4 配置文件删不掉/权限拒绝怎么办Windows下配置文件被占用的根因多半是OpenClaw的托盘进程或计划任务还在运行先把进程按前文方法杀掉。如果还提示需要管理员权限那确认你是以管理员PowerShell执行的或者用“强力删除工具”处理不过一般到不了这一步。Linux下权限拒绝的核心原因通常是文件属于另一个用户或root。因为是root创建的缓存当前用户无权限删除必须用sudosudo rm -rf ~/.openclaw这里有一种情况要小心如果~/.openclaw是root所有而你之前用普通用户卸载那么sudo rm -rf ~/.openclaw会连整个目录一并删除。但如果你对root用户删普通用户目录有顾虑可以用chown方式把所有权归回当前用户再删。其实没差别干净利落就行。另外Linux上还有一种删不掉的情况文件系统开启了不可变属性chattr i。有些安全加固脚本会这么干。检查方式lsattr ~/.openclaw # 如果看到 i 属性用下面命令解除 sudo chattr -i ~/.openclaw sudo rm -rf ~/.openclaw“不可变属性”这个概念比较冷门但知道一次省去未来很多折腾。5. 判断“卸载干净”的标准与重装建议5.1 用三条验证命令行判断卸载结果我整理了一个快速的验证清单按顺序执行全部通过才算卸载干净。Windows下打开PowerShellLinux下打开终端# 验证1命令是否还生效预期输出找不到命令 openclaw --version # 验证2全局包是否残留预期输出无匹配项 npm ls -g | findstr /i openclaw # 验证3docker容器是否残留预期输出无匹配项 docker ps -a | findstr /i openclawLinux用户把findstr换成grep命令逻辑一样。除此之外再检查一下配置目录是否存在ls -la ~/.openclaw如果上面的命令都没有返回任何内容基本可以断定卸载干净了。执行完这三条大约只需要十秒钟但能确认你前面花的所有时间都值了。5.2 未来重装时的注意事项说句实在话很多人卸载OpenClaw不是因为它不好用而是配置过程过于折腾——要么是显卡驱动没弄好导致本地推理跑不起来要么是网络环境限制导致模型API连不上要么是遇到session file locked这类问题后心态炸了。卸载之后夜深人静又想重新试试的也不在少数。如果你确实打算过阵子重装我的建议是不要立刻删光所有配置尤其是有会话数据、自定义技能、知识库索引的目录。在卸载前先做一次备份比如tar -czf openclaw-backup.tar.gz ~/.openclaw反正tar体积不大留着不吃亏。重装前务必确认Node.js版本满足要求OpenClaw这类大模型应用框架对Node版本要求较高版本太旧会报GLIBC错误或Node语法错误。重装时不要一股脑跑一键脚本搞清楚它到底是否往systemd里注册了服务、是否修改了你的PATH、是否创建了特殊的临时目录。这能让你未来再卸载时少走弯路。我自己经历过一次“装了三遍、卸了三遍”的过程每次踩的坑都不一样第一遍是npm缓存问题第二遍是端口冲突第三遍是环境变量残留。后来我养成了一个习惯不管是安装还是卸载先记下自己执行过哪些命令修改过哪些文件这比任何“一键清理工具”都靠谱。5.3 个人实操体会最后聊点实在的。很多AI应用框架的开发者在设计时更关注“怎么跑起来”而很少认真写“怎么卸干净”。OpenClaw作为一个大模型智能体框架它由Node进程、全局CLI、本地配置、浏览器自动化内核、可能还带Docker容器这几个部分组成任何一个环节处理不干净都会留下“幽灵文件”。我在实际卸载中发现最有用的一个习惯是在卸载前先打一个快照。Windows下给C盘做个系统还原点Linux下tar备份一下配置目录。正常情况后这个快照你永远不会用上但一旦卸载过程中手误删了某个还在用的共享库或者系统提示某些核心组件被依赖快照就是你的后悔药。另外卸载OpenClaw这种大模型应用时多留一个心眼看看它相关联的依赖——尤其是我前面反复提到的Playwright浏览器缓存这玩意儿体积大、隐蔽、不自知。有时候你觉得自己只是卸载了一个应用硬盘并没有清出空间十有八九就是浏览器内核没清理。这篇内容的实用价值就在这里——照着上面的步骤一步步操作你的Windows或Linux系统就能干干净净地告别OpenClaw不留进程、不留文件、不留环境变量、不留自启动项。下次想装回来的时候也请记得把这些步骤倒过来走一遍。我踩过的那些坑希望你能一步跳过去。
OpenClaw完全卸载指南：Windows/Linux无残留清理方法
1. 卸载前先搞清楚OpenClaw到底装到了哪里先说核心结论OpenClaw作为一个基于Node.js生态的大模型应用框架它的卸载逻辑和传统桌面软件完全不同。传统软件装完后在“控制面板-添加删除程序”里点一下就完事但OpenClaw这种通过命令行、脚本或Docker部署的AI智能体框架安装时会往系统里塞进好几个部分程序本体、全局命令、配置文件、数据目录、可能还有开机自启的服务。只删掉其中一块过几天你会发现它又在后台偷偷运行了。我见过不少在新手在卸载OpenClaw时犯的一个典型错误打开项目目录发现有个文件夹叫openclaw右键删除然后觉得卸载完了。结果一打开终端敲openclaw命令照样能执行。这就是因为全局命令还链接着PATH环境变量里也残留着旧路径。所以卸载OpenClaw的正确姿势第一步不是删文件而是搞清楚这个Agent框架的部署形态。根据你当初安装方式的不同OpenClaw通常会以三种形态之一出现在系统里npm全局包安装如果你在终端执行过npm install -g openclaw/openclaw或类似的全局安装命令那么它会作为一个全局Node模块存在。可以通过npm ls -g查到具体位置Windows上一般在%APPDATA%\npm\node_modules下Linux则多在/usr/lib/node_modules或/usr/local/lib/node_modules。git clone 本地启动很多人按照网上的教程会把项目源码clone到本地比如git clone https://github.com/xxx/openclaw.git然后再手动配置token、启动服务。这种情况下并没有全局命令而是在项目目录下通过node或npm start运行。你的卸载对象主要就是这个文件夹以及散落在用户目录下的配置。Docker容器部署如果你用了官方提供的一键部署Docker方案OpenClaw会跑在一个容器里通过映射端口对外提供服务。卸载需要操作镜像、容器、挂载卷三样东西。每个平台的工具链还不一样Windows上用PowerShell和任务管理器Linux上则是systemd、ps、crontab这些。下面我会按平台拆开讲但请你先照这个方法自查一下打开终端分别执行openclaw --version、npm ls -g | findstr openclawWindows或npm ls -g | grep openclawLinux、docker ps -a | grep openclaw看看装的是哪一种。这三种命令的输出能让你在一分钟内判断出自己当初是怎么装的后面的卸载路径也就清楚了。注意如果你当初是通过“一键部署脚本”安装的这种脚本通常会自动帮你注册systemd服务Linux或计划任务Windows卸载时只删目录会留下自启动残骸。判断方法重启一次系统然后打开终端敲openclaw或者查进程列表如果服务自动起来了说明一定有自启项没有清掉。还有一个容易漏的地方OpenClaw这类大模型Agent框架往往会内置浏览器自动化插件比如Playwright/Puppeteer相关组件卸载npm包不会自动删除浏览器内核和缓存目录。Windows下它们躺在%LOCALAPPDATA%\ms-playwrightLinux下则是~/.cache/ms-playwright。普通人卸载后硬盘多出几个G的残留基本都是这玩意儿。后面我会给清理方案。2. Windows平台卸载OpenClaw的完整实操2.1 第一步停掉进程和后台服务否则锁文件会让你崩溃在Windows上卸载OpenClaw遇到的第一个拦路虎往往不是权限而是进程占用。如果你当初启用了openclaw serve这种常驻服务模式那么就算关掉了终端窗口后台可能还挂着Node进程。Windows下如果直接删除文件会碰上一堆“文件正在被另一个进程使用”的报错网上搜到的那个报错信息agent failed before reply: session file locked (timeout 60000ms)本质上就是Node把session文件锁定住了。正确的停进程方式不是去任务管理器里翻而是用管理员权限打开PowerShell执行# 先找到OpenClaw相关的进程 tasklist | findstr /i openclaw tasklist | findstr /i node # 找到结束后按PID精确结束 taskkill /F /PID 12345 # 如果它跑在服务里还需要停服务 Get-Service -Name *openclaw* | Stop-Service -Force sc.exe delete OpenClawService这里我想特别说明为什么不要直接taskkill /F /IM node.exe一股脑把所有Node进程杀掉你这台机器上很可能还跑着其他基于Node的工具比如某个本地开发服务器、某个编辑器插件全杀掉会造成连带伤害。我自己的习惯是先tasklist | findstr node观察一下哪些进程的命令行里带openclaw关键字再精准狙击。另一个隐蔽的位置是Windows任务计划程序。一键部署脚本有时会把“开机自动启动OpenClaw”做成一个计划任务。你光停进程是没用的重启后又活了。检查方法schtasks /query | findstr /i openclaw # 如果找到删除它 schtasks /delete /TN OpenClawAutoStart /F2.2 第二步按安装方式分别卸载确认进程都停了之后回到安装方式的判断上三选一如果你用的是npm全局安装在管理员PowerShell里执行npm uninstall -g openclaw/openclaw注意npm卸载只会移除node_modules下的包文件和bin链接但不会清理配置文件。所以执行完以后还得到用户目录下手动删。常见的配置路径有C:\Users\你的用户名\.openclaw\C:\Users\你的用户名\.config\openclaw\C:\Users\你的用户名\.claw\如果环境变量里设置了OPENCLAW_HOME之类的自定义位置那配置文件就会在对应路径下可以用echo %OPENCLAW_HOME%查一下。如果你是git clone 或下载压缩包方式安装的那就更直接找到源码目录直接ShiftDelete删除即可。但删除前务必先把上面的配置目录删掉不然下次重新clone依然会读取到旧配置。如果你是Docker部署的不要直接去Docker Desktop里删容器正确顺序是# 停掉并移除容器 docker stop openclaw-container docker rm openclaw-container # 删除挂载卷注意卷名以实际docker volume ls为准 docker volume ls | findstr openclaw docker volume rm openclaw_config # 最后删镜像 docker rmi openclaw-image为什么强调先删卷再删镜像因为Docker镜像本身只是一个只读模板配置和数据都在卷里如果把配置丢了但镜像还在你重新run一条命令就全部复现了。如果先删镜像但卷还在那下次运行同版本镜像时还会载入旧配置。两样都要清才叫卸载干净。2.3 第三步清理PATH环境变量和残留配置npm全局包卸载后npm会自动尝试清理bin链接但有时候因为路径带空格、权限异常等原因系统PATH里的C:\Users\用户名\AppData\Roaming\npm并不会自动移除 —— 这个路径本身是npm全局bin的公共路径一般不建议删掉整条但可以检查一下有没有单独指向openclaw自定义bin的条目。具体做法右键“此电脑” → 属性 → 高级系统设置 → 环境变量在“用户变量”和“系统变量”的Path里翻一遍凡是形如C:\Users\用户名\AppData\Roaming\npm\node_modules\openclaw...这样的条目直接删除。然后是隐藏残留。OpenClaw在Windows下会用%LOCALAPPDATA%存储一些运行时缓存做得隐蔽一点的文件在C:\Users\用户名\AppData\Local\openclaw和C:\Users\用户名\AppData\Local\Temp\openclaw*。特别是Date目录下的数据文件如果卸载不彻底你下次重装后会看到历史会话自动同步出来——对隐私敏感的人来说这个非常要命。稳妥做法是把下面几个位置都扫一遍$paths ( $env:APPDATA\openclaw, $env:APPDATA\npm\node_modules\openclaw, $env:LOCALAPPDATA\openclaw, $env:LOCALAPPDATA\ms-playwright, $env:USERPROFILE\.openclaw, $env:USERPROFILE\.claw ) foreach ($p in $paths) { if (Test-Path $p) { Write-Host 发现残留目录: $p ($((Get-Item $p).Length 字节约)) } }浏览器自动化内核那一项如果你之前用的OpenClaw版本强制依赖Playwright浏览器就会在ms-playwright目录下缓存Chromium。这个文件夹可能有几百MB到1GB多删不删取决于你是否还需要其他Playwright项目。如果确认不需要直接右键删除即可。2.4 Windows下容易忽略的三个坑第一个坑是安全软件拦截。Windows Defender有时候会把OpenClaw的自动化脚本识别为可疑程序卸载过程中如果有文件删不掉十有八九是Defender正在后台扫描。你可以先临时关一下实时防护卸载完再打开。第二个坑是WSL和Windows双环境。很多教程会让你在Windows自带的Linux子系统WSL里装OpenClaw。如果是这种部署你在Windows桌面侧怎么删都没用得进WSL环境里去卸载。思路和Linux完全一致直接跳到下一节看。第三个坑是环境变量里的NODE_OPTIONS。有些部署脚本为了讲OpenClaw连上大模型API会往系统环境变量里塞NODE_OPTIONS--max-old-space-size4096。卸载OpenClaw后这个变量如果还留着会影响其他Node项目的运行内存分配。检查方法环境变量面板搜NODE_OPTIONS如果是单独为OpenClaw设置的记得一并删除。3. Linux平台卸载OpenClaw的完整实操3.1 第一步识别并停用systemd服务Linux上的OpenClaw部署比Windows更常见也更隐蔽。很多一键脚本装完后会以systemd服务的形式托管即使你关机重启它也会自动拉起。这是Linux上卸载OpenClaw最关键的环节。我一贯的建议是先别急着删文件用下面一组命令把“服务层”的东西翻个底朝天# 查找所有带 openclaw 字样的服务 systemctl list-unit-files | grep -i openclaw # 如果有服务单元比如 openclaw.service执行停止禁用 sudo systemctl stop openclaw.service sudo systemctl disable openclaw.service # 删除服务单元文件 sudo rm /etc/systemd/system/openclaw.service sudo systemctl daemon-reload这里disable和stop是两码事。stop只针对当前运行状态disable才是确保下次开机不再自启。很多过来人只跑了stop重启后服务又活了然后怀疑自己是不是卸载了个寂寞。daemon-reload也别忘了跑它让systemd重新扫描单元文件否则旧配置还会留在内存缓存里。还有一种情况是有人用supervisor或pm2来托管OpenClaw进程常见于生产环境。如果是pm2托管的需要pm2 list | grep openclaw pm2 delete openclaw-app pm2 savepm2有个坑pm2 delete只是删掉当前守护进程列表如果你没有执行pm2 save重启pm2后它可能根据旧的dump文件重新拉起。所以pm2 delete和pm2 save必须连着执行。3.2 第二步区分三种安装方式并逐个清理Linux下卸载OpenClaw一定要先判断它是npm包、源码还是Docker。判断命令which openclaw npm ls -g | grep -i openclaw docker ps -a | grep -i openclaw如果是npm全局包卸载命令和Windows大同小异npm uninstall -g openclaw/openclaw但这里有个Linux特有的细节npm全局包的bin符号链接位于/usr/local/bin或/usr/bin卸载后如果链接没删干净shell的hash缓存还会“记住”旧路径。执行完卸载后建议跑一下hash -r刷新一下命令缓存否则你在同一个终端会话里敲openclaw还是会报“命令已找到但无法执行”的诡异错误。如果是git clone 源码部署直接递归删除目录并清理用户级配置rm -rf ~/openclaw rm -rf ~/.openclaw rm -rf ~/.config/openclaw rm -rf ~/.local/share/openclaw如果是Docker 部署按顺序清理容器、卷、镜像docker ps -a | grep openclaw docker stop 容器名或ID docker rm 容器名或ID docker volume ls | grep openclaw docker volume rm 卷名 docker images | grep openclaw docker rmi 镜像ID提示Linux下Docker卷一旦删除不可恢复。如果你因为调试问题卸载OpenClaw打算过阵子再装回来建议在卸载前先用docker cp把卷里的配置备份到宿主机等重装时再拷回去。我经历过一次删卷后找不到会话记录的事后来学乖了——凡是容器类应用卸载前一律先备份。3.3 第三步清理crontab、日志和残留库文件Linux部署中最容易被忽略的残留是两个地方定时任务和日志轮转配置文件。OpenClaw社区里有些方案为了保持Agent的长活会建议你往crontab里塞一条定时重启或自检的命令。卸载时这条cron不会自动消失。检查并清理crontab -l | grep -i openclaw # 如果存在编辑删除 crontab -e日志文件的位置一键脚本一般会写在/var/log/openclaw/但也不排除写到~/.openclaw/logs。虽然日志不参与运行但包含大量会话内容涉及数据隐私最好一并清掉。别忘了还有临时目录/tmp/openclaw-*。此外很多Linux一键部署OpenClaw的脚本会顺手安装一个pm2-logrotate模块或者创建/etc/logrotate.d/openclaw配置。找到后同样删除sudo rm /etc/logrotate.d/openclaw还有一个很多人踩的坑次版本残留。Node版本升级后~/.npm/_cacache里可能有OpenClaw相关的缓存包非常占空间。执行一次npm缓存清理npm cache clean --force这条命令会把整个npm缓存清空听起来很暴力但如果这台机器今后还要开发其他Node项目其实清空后重新拉取就行只是在慢网络上首次安装时稍微慢一点。如果你很介意也可以只删除~/.npm/_cacache里带openclaw字母的目录不过操作起来比较麻烦我一般图省事直接全清。3.4 Linux下容易忽略的三个坑第一个坑是NVM安装的Node全局包。如果你用的是nvm管理多个Node版本那么npm uninstall -g只是卸载了当前激活版本的全局包。其他Node版本下的全局包还藏着呢。切换版本后用which openclaw再确认一遍确保每个版本里都卸干净了。第二个坑是Shell启动脚本里的残留别名。有些用户在.bashrc或.zshrc里加过alias openclawnode ~/openclaw/index.js这类快捷命令。卸载时不查shell配置下次打开终端依然能呼起命令还会误以为卸载失败。检查一下~/.bashrc、~/.zshrc、~/.profile把相关行删掉并source一下即可。第三个坑是Docker容器外的端口转发。如果你用docker run -p 3000:3000配合iptables暴露过端口卸载容器后iptables规则一般会被Docker自动清理但如果你手动加过Nginx反向代理配置比如/etc/nginx/conf.d/openclaw.conf卸载容器后Nginx还在那个反代配置会一直报502。记得一并删配置并nginx -s reload。4. 卸载常见问题与排查技巧4.1 报错“session file locked”怎么办这个报错在搜索热词里出现了对应的报错原文是agent failed before reply: session file locked (timeout 60000ms)。它不只在运行时出现卸载时也可能会碰到——表现形式是文件删不掉提示被占用。这背后的原理是OpenClaw会把会话状态写入一个JSON文件并通过文件锁机制防止多个进程同时写入。如果进程异常退出锁文件可能残留。卸载前最安全的做法是先把所有相关进程结束掉前面章节的停进程步骤然后再删除整个会话目录。如果进程已经结束了但锁文件还在Windows下直接强删rm -Force $env:USERPROFILE\.openclaw\sessions\*Linux下rm -f ~/.openclaw/sessions/*.lock你甚至可以不用纠结是哪个文件锁直接把.openclaw整个目录删掉一了百了。4.2 卸载后端口仍然被占用怎么办卸载完OpenClaw后你用netstat -ano | findstr 3000Windows或ss -tlnp | grep 3000Linux发现端口依然被监听。最常见的可能性是你只停了一个进程但OpenClaw的某些辅助服务还在跑——比如内置的浏览器自动化服务、WebSocket通知服务等。Windows下用netstat -ano | findstr :端口号查出PID然后tasklist /FI PID eq PID号确认进程名再结束。Linux下则要留意Python和Node都是可能的宿主不能只想着找openclaw字样的进程名因为Linux进程名截断问题你ps看到的名字可能只是node或python要看它的完整启动命令行ps aux | grep -v grep、/proc/PID/cmdline来确认关联。4.3 卸载后命令仍然可执行的三个排查方向如果你执行完上述所有步骤终端里敲openclaw还能呼起帮助信息逃不出以下几种情况全局alias或shell函数还留着。检查.bashrc、.zshrc、.bash_profile里的alias。NVM多版本下的全局包。切换Node版本再卸载一次。npm缓存中的“幽灵包”。某些npm版本在卸载失败时会在node_modules/.bin下留下空链接。直接查看/usr/local/bin/openclaw或/usr/bin/openclaw是否指向一个不存在的路径如果是手动rm删除。我遇到过一次最离奇的用户用一个带空格的目录名安装了OpenClawnpm卸载时因为路径解析问题没有删掉bin链接。最后手动删掉了/usr/local/bin/openclaw对应的符号链接才彻底解决。因为这种边缘情况我的建议永远是最后执行一条验证which openclaw只要它返回一个路径你就要继续追查那个路径是从哪来的。4.4 配置文件删不掉/权限拒绝怎么办Windows下配置文件被占用的根因多半是OpenClaw的托盘进程或计划任务还在运行先把进程按前文方法杀掉。如果还提示需要管理员权限那确认你是以管理员PowerShell执行的或者用“强力删除工具”处理不过一般到不了这一步。Linux下权限拒绝的核心原因通常是文件属于另一个用户或root。因为是root创建的缓存当前用户无权限删除必须用sudosudo rm -rf ~/.openclaw这里有一种情况要小心如果~/.openclaw是root所有而你之前用普通用户卸载那么sudo rm -rf ~/.openclaw会连整个目录一并删除。但如果你对root用户删普通用户目录有顾虑可以用chown方式把所有权归回当前用户再删。其实没差别干净利落就行。另外Linux上还有一种删不掉的情况文件系统开启了不可变属性chattr i。有些安全加固脚本会这么干。检查方式lsattr ~/.openclaw # 如果看到 i 属性用下面命令解除 sudo chattr -i ~/.openclaw sudo rm -rf ~/.openclaw“不可变属性”这个概念比较冷门但知道一次省去未来很多折腾。5. 判断“卸载干净”的标准与重装建议5.1 用三条验证命令行判断卸载结果我整理了一个快速的验证清单按顺序执行全部通过才算卸载干净。Windows下打开PowerShellLinux下打开终端# 验证1命令是否还生效预期输出找不到命令 openclaw --version # 验证2全局包是否残留预期输出无匹配项 npm ls -g | findstr /i openclaw # 验证3docker容器是否残留预期输出无匹配项 docker ps -a | findstr /i openclawLinux用户把findstr换成grep命令逻辑一样。除此之外再检查一下配置目录是否存在ls -la ~/.openclaw如果上面的命令都没有返回任何内容基本可以断定卸载干净了。执行完这三条大约只需要十秒钟但能确认你前面花的所有时间都值了。5.2 未来重装时的注意事项说句实在话很多人卸载OpenClaw不是因为它不好用而是配置过程过于折腾——要么是显卡驱动没弄好导致本地推理跑不起来要么是网络环境限制导致模型API连不上要么是遇到session file locked这类问题后心态炸了。卸载之后夜深人静又想重新试试的也不在少数。如果你确实打算过阵子重装我的建议是不要立刻删光所有配置尤其是有会话数据、自定义技能、知识库索引的目录。在卸载前先做一次备份比如tar -czf openclaw-backup.tar.gz ~/.openclaw反正tar体积不大留着不吃亏。重装前务必确认Node.js版本满足要求OpenClaw这类大模型应用框架对Node版本要求较高版本太旧会报GLIBC错误或Node语法错误。重装时不要一股脑跑一键脚本搞清楚它到底是否往systemd里注册了服务、是否修改了你的PATH、是否创建了特殊的临时目录。这能让你未来再卸载时少走弯路。我自己经历过一次“装了三遍、卸了三遍”的过程每次踩的坑都不一样第一遍是npm缓存问题第二遍是端口冲突第三遍是环境变量残留。后来我养成了一个习惯不管是安装还是卸载先记下自己执行过哪些命令修改过哪些文件这比任何“一键清理工具”都靠谱。5.3 个人实操体会最后聊点实在的。很多AI应用框架的开发者在设计时更关注“怎么跑起来”而很少认真写“怎么卸干净”。OpenClaw作为一个大模型智能体框架它由Node进程、全局CLI、本地配置、浏览器自动化内核、可能还带Docker容器这几个部分组成任何一个环节处理不干净都会留下“幽灵文件”。我在实际卸载中发现最有用的一个习惯是在卸载前先打一个快照。Windows下给C盘做个系统还原点Linux下tar备份一下配置目录。正常情况后这个快照你永远不会用上但一旦卸载过程中手误删了某个还在用的共享库或者系统提示某些核心组件被依赖快照就是你的后悔药。另外卸载OpenClaw这种大模型应用时多留一个心眼看看它相关联的依赖——尤其是我前面反复提到的Playwright浏览器缓存这玩意儿体积大、隐蔽、不自知。有时候你觉得自己只是卸载了一个应用硬盘并没有清出空间十有八九就是浏览器内核没清理。这篇内容的实用价值就在这里——照着上面的步骤一步步操作你的Windows或Linux系统就能干干净净地告别OpenClaw不留进程、不留文件、不留环境变量、不留自启动项。下次想装回来的时候也请记得把这些步骤倒过来走一遍。我踩过的那些坑希望你能一步跳过去。
