官方卸载命令失效OpenClaw 手动卸载终极方案作为一个从OpenClaw早期版本就开始折腾的老用户我可以负责任地告诉你这个AI Agent框架确实好用但卸载这件事绝对没有官方文档写得那么轻松。我遇到的不止一次执行官方提供的claw uninstall之后以为清理干净了结果重启终端发现claw --version还能输出版本号甚至后台进程还默默占着端口。更别提那些通过Docker部署、手动编译、Windows下安装的朋友一旦官方卸载脚本跑不动整个系统就像吃了顿没消化完的饭难受又甩不掉。所以这篇就把我踩过的坑、试过的路子、总结出的手动卸载终极方案全部分享出来覆盖Linux、macOS、Windows和Docker场景该删的都删干净。哪怕官方命令废了你也照样能收干净尾巴。1. 先搞清楚 OpenClaw 到底在系统里装了什么1.1 官方卸载命令通常想干什么但为什么经常干不干净官方卸载命令的设计思路一般是执行一个uninstall脚本或者调用内置的claw uninstall子命令它会尝试停止服务、删除安装目录、清理用户配置。听起来很美好但实际操作中它只覆盖了一套理想路径。什么情况会翻车最常见的三个原因第一权限问题脚本用当前用户权限运行但安装时用了sudo导致/usr/local/bin或者/opt下的文件删不动第二进程占用OpenClaw的server进程还在后台跑着Windows服务或者systemd服务没有真正停掉文件被锁定删除操作直接失败第三自定义部署路径你用手动编译或者Docker Compose方式安装官方脚本根本不知道你把自己的东西放在哪儿扫一圈找不到就以为干净了。所以想彻底卸载第一步不是急着敲命令而是先搞清楚你当初是怎么装的。安装方式决定了残留文件分布在哪些目录这就像打扫房间先知道垃圾扔在哪些角落才能一次扫干净。1.2 不同安装方式对应的残留文件分布我整理过一份自己实测过的目录对照表基本涵盖OpenClaw的三种主流安装路径大家可以用这张表先自查一下自己的系统。安装方式可执行文件位置配置及数据目录额外残留一键脚本install.sh/usr/local/bin/claw、/usr/local/bin/openclaw~/.config/openclaw、~/.local/share/openclaw、~/.cache/openclaw/opt/openclaw部分版本、systemd服务文件Docker/Compose无程序在容器内命名volume或挂载目录容器、镜像、网络、compose项目目录手动编译go build/usr/local/bin/claw或自定义路径$HOME/.openclaw、~/.config/openclaw源码目录、Go编译缓存Windows安装包%LOCALAPPDATA%\OpenClaw\bin\claw.exe%APPDATA%\OpenClaw、%USERPROFILE%\.openclaw计划任务、注册表启动项、快捷方式这里要特别提醒一句不要只删一个目录就完事。OpenClaw的很多配置数据是分离的比如Agent记忆、渠道接入信息Teams、飞书、千问API key等可能都存在~/.local/share/openclaw下而配置文件在~/.config/openclaw下。如果你只删了config轻轻松松还留着几百MB的缓存数据等于没卸干净。2. 卸载前必做的数据备份与确认2.1 为什么卸载前一定要备份有朋友可能会说都卸载了还备份什么 这句话我听过太多次然后过几天就有人回来哭诉我忘了把飞书渠道的机器人Token导出来现在想换台机器重新配置结果完全找不到原来那个应用密钥了。 OpenClaw里存的不是简单的账号密码还有Agent的记忆数据、对话历史、技能配置、各种渠道的webhook地址和身份凭证。这些东西一旦删了就是真没了官方文档可不会帮你找回。另外备份也是一个确认过程。通过备份你能直观看到OpenClaw到底在哪些地方落过地。很多残留文件其实在备份的时候就会暴露出来。所以卸载前花五分钟做一次快照绝对不亏。2.2 备份操作的具体步骤以Linux/macOS为例我习惯的做法是# 创建备份目录 mkdir -p ~/openclaw-backup # 备份配置文件 cp -r ~/.config/openclaw ~/openclaw-backup/config # 备份数据文件记忆、日志、渠道状态 cp -r ~/.local/share/openclaw ~/openclaw-backup/data # 备份缓存目录有时候里面存了模型会话上下文 cp -r ~/.cache/openclaw ~/openclaw-backup/cache # 如果有独立的数据库文件比如SQLite cp ~/.local/share/openclaw/openclaw.db ~/openclaw-backup/ 2/dev/null如果你是用Docker部署的备份的容器数据卷。假设你的volume名字叫openclaw_data可以用下面的方式导出一份tar包docker run --rm -v openclaw_data:/data -v ~/openclaw-backup:/backup alpine tar czf /backup/openclaw_data.tar.gz -C /data .备份完成以后别急着删。先把OpenClaw自带的配置导出命令也跑一遍比如有的版本支持claw config export ~/openclaw-backup/config.yaml这能把你接入Teams、飞书时填的那些token和channel配置一次性导出来后续如果要重新部署直接导入就能用。这一步很多人忽略但真到重建环境的时候才知道多值钱。3. 手动卸载的核心步骤Linux/macOS这是整篇文章的重点也是我在无数台服务器上验证过的流程。适用于一键脚本安装、手动编译安装等所有非Docker场景。整个顺序遵循一个原则先停进程再删系统级文件然后删用户级文件最后清自启动和服务残留。顺序错了很可能会遇到文件占用、命令仍然生效之类的问题。3.1 第一步停止所有相关进程和服务千万不要跳过这一步就直接rm。OpenClaw的server进程一旦还在运行它会不断重新生成日志文件、锁文件甚至在某些版本里还会自己守护重启。你得先把进程干掉。通用的做法先查找进程ps aux | grep -E openclaw|claw | grep -v grep如果看到类似/usr/local/bin/claw serve或者openclaw-agent的进程直接杀掉sudo pkill -f openclaw sudo pkill -f claw serve如果OpenClaw被systemd管理需要这样处理# 查看服务名称 systemctl list-units | grep -i claw # 停止并禁用服务用户级和系统级都可能存在 sudo systemctl stop openclaw sudo systemctl disable openclaw systemctl --user stop openclaw 2/dev/null systemctl --user disable openclaw 2/dev/null停完以后再执行一次ps aux | grep -i claw确认没有漏网之鱼。还有一个容易被忽略的地方OpenClaw可能会通过Docker运行辅助进程比如数据库、模型代理这些进程名里不一定带claw字样。如果你发现杀完OpenClaw主进程后某些端口依然被占用就要用下一章的端口排查法找真凶。3.2 第二步删除可执行文件与系统级链接进程停了文件就能删了。先找到claw命令的准确位置which claw which openclaw ls -la $(which claw)第三个命令重点看它是不是一个软链接。如果是链接要同时删掉链接和真实目标文件。我自己就遇到过claw是指向/opt/openclaw/bin/claw的软链接只删链接不删目标等于没删。接下来执行删除# 删除通用二进制路径 sudo rm -f /usr/local/bin/claw /usr/local/bin/openclaw # 删除可能的项目目录 sudo rm -rf /opt/openclaw sudo rm -rf /usr/local/lib/openclaw # 如果手动编译删除源码目录 rm -rf ~/openclaw ~/src/openclaw删除后立刻测试命令是否还认识它hash -r claw --version如果提示command not found说明这一步成功了。如果还在说明PATH里还有别的副本用whereis claw继续找。3.3 第三步清理用户级配置和缓存这一步在删除残留数据但即便你备份过了我仍然建议不要暴力rm -rf ~下所有带claw的目录。先列出来看看再删做到心里有数ls -la ~ | grep -i claw ls -la ~/.config | grep -i claw ls -la ~/.local/share | grep -i claw ls -la ~/.cache | grep -i claw那些隐藏目录比如~/.openclaw、~/.claw也都要查。有些版本的agent会把会话状态放在~/.claw/agents下面整个session目录不删下次装回来老数据还阴魂不散。确认后删除rm -rf ~/.config/openclaw rm -rf ~/.local/share/openclaw rm -rf ~/.cache/openclaw rm -rf ~/.openclaw rm -rf ~/.claw有朋友问删了会不会影响其他软件一般来说不会因为这些目录是OpenClaw专用的。但有一种情况要小心如果你把OpenClaw的数据目录自定义到了其他项目的共用目录比如~/data那删的时候就要精准删子文件夹别整个~/data都端了。所以我在前面说先备份、先列出再删就是为了避免这种误伤。3.4 第四步清理环境变量和Shell配置这是最容易被忽视的部分。很多通过脚本安装的版本会自动往~/.bashrc、~/.zshrc、~/.profile里写入环境变量或别名。不删干净会出现什么症状就是终端一打开提示OPENCLAW_HOME指向目录不存在或者敲一个claw前缀的命令时自动补全一个死掉的路径。检查方法grep -n -i claw ~/.bashrc ~/.zshrc ~/.profile ~/.config/fish/config.fish 2/dev/null常见需要清理的内容包括export OPENCLAW_HOME$HOME/.openclaw export PATH$HOME/.openclaw/bin:$PATH alias claw~/openclaw/dist/claw找到以后用文本编辑器把这些行注释或删掉。注意语法别把其他程序的PATH配置一起误删。清理完以后重新加载配置再确认source ~/.bashrc env | grep -i claw如果输出为空环境变量就清干净了。3.5 第五步清理systemd、cron等自启动残留这是看起来卸载成功、重启后就原形毕露的元凶。OpenClaw在安装时可能会创建systemd服务、用户级服务、launchdmacOS任务甚至还会在crontab里放一条定时重启的cron命令。你只删文件它下次开机还会自动拉起来跑。Linux下systemd清理# 查看所有相关的服务单元 systemctl list-unit-files | grep -i claw # 彻底删除服务文件 sudo rm -f /etc/systemd/system/openclaw.service sudo rm -f /etc/systemd/system/openclaw-server.service rm -f ~/.config/systemd/user/openclaw.service # 重新加载systemd sudo systemctl daemon-reload systemctl --user daemon-reloadcron清理crontab -l | grep -i claw # 如果上面有输出用 crontab -e 编辑删除对应行macOS下launchd清理launchctl unload ~/Library/LaunchAgents/com.openclaw.plist 2/dev/null rm -f ~/Library/LaunchAgents/com.openclaw.plist sudo launchctl unload /Library/LaunchDaemons/com.openclaw.plist 2/dev/null sudo rm -f /Library/LaunchDaemons/com.openclaw.plist清理完服务再检查一下登录启动项比如Ubuntu的autostart、GNOME的.desktop文件ls ~/.config/autostart | grep -i claw有就一并删掉。这步做完了你在Linux/macOS上的手动卸载才算真正完成。4. 特殊场景Docker 部署的手动清理Docker部署的OpenClaw官方卸载命令经常直接懵。因为容器环境里卸载脚本根本看不到宿主机的路径更别谈删镜像和卷。而且很多朋友还是用docker compose up -d拉起来的compose文件所在的目录本身也是一处残留。下面我说下标准处理流程。4.1 先停容器再删镜像和卷顺序别乱首先查看正在运行的OpenClaw容器docker ps | grep -i claw docker ps -a | grep -i claw记录容器ID或名字然后停止并删除docker stop 容器ID或名字 docker rm 容器ID或名字如果你当初是run起来而不是compose管理的可能还有一组数据卷。查一下docker volume ls | grep -i claw比如看到名字是openclaw_pgdata或openclaw_data在删除前先确认备份然后执行docker volume rm openclaw_pgdata openclaw_data接着删除镜像docker images | grep -i claw找到镜像ID后docker rmi 镜像ID这里有个心得镜像删不掉通常是因为有容器在引用它哪怕是已停止的容器。所以docker rm必须走在docker rmi前面。如果你有一堆退出状态的残留容器可以用docker container prune一锅端但要注意它会删除所有不再使用的容器如果你机器上还有其他项目就不要用这个老老实实按容器ID删。4.2 Compose 项目目录和网络清理如果是compose方式部署的删容器只是第一步。你会发现当初写docker-compose.yml的那个目录还在里面可能挂着.env文件里面存着各种渠道的token和密钥。这个目录必须删不然等于把钥匙留在门垫下面。标准操作是cd ~/openclaw-compose # 你当初部署的目录 docker compose down -v cd ~ rm -rf ~/openclaw-compose-v参数会连带删除compose文件中定义的volumes这一步会把数据全部抹掉。所以再次强调执行down -v前一定确认不再需要数据。如果你只想先卸载、保留数据那就用docker compose down不带-v。还有一个容易被忽略的是网络。compose有时会自己创建一个bridge网络比如openclaw_default。删除项目后这个网络会留着。查一下docker network ls | grep -i claw docker network rm openclaw_default另外如果你用systemd方式管理compose容器可能写在openclaw的warpper脚本里记得回到上面的服务清理步骤把对应的systemd unit删掉。最后如果整个系统的Docker资源比较乱可以在确保不影响其他容器的情况下用docker builder prune清一下构建缓存。但我不建议一上来就docker system prune -a那个命令会把你机器上所有不相关的镜像、网络、缓存全删掉太激进没必要为了卸载OpenClaw伤及无辜。5. Windows 平台卸载的坑5.1 官方卸载命令在 Windows 失效的常见原因Windows上的OpenClaw卸载问题更多甚至可以说官方脚本就是个摆设。我帮好几个朋友远程处理过症状五花八门有的说PowerShell执行卸载脚本直接报在此系统上禁止运行脚本有的说提示拒绝访问还有的说跑到一半卡死进程杀了又自动重启。总结下来根因就三类第一PowerShell执行策略限制。很多安装脚本需要Set-ExecutionPolicy RemoteSigned但卸载脚本如果没考虑到这点直接执行.ps1文件就会报错。第二文件占用。OpenClaw的server进程在后台运行Windows下文件被占用后删除操作不会报错但删不掉然后脚本还自我感觉良好。第三安装路径带空格比如C:\Program Files\OpenClaw脚本里的路径解析直接炸掉。5.2 Windows 手动卸载步骤Windows下我推荐直接用PowerShell管理员模式手动操作比任何第三方卸载工具都干净。先停止进程Get-Process | Where-Object {$_.Name -like *claw*} | Stop-Process -Force然后删除安装目录和配置目录。需要特别注意Windows下有两个位置特别隐蔽# 可执行文件目录 Remove-Item -Recurse -Force $env:LOCALAPPDATA\OpenClaw Remove-Item -Recurse -Force $env:LOCALAPPDATA\Programs\OpenClaw -ErrorAction SilentlyContinue # 用户配置目录 Remove-Item -Recurse -Force $env:APPDATA\OpenClaw Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw Remove-Item -Recurse -Force $env:USERPROFILE\.claw如果安装了服务可以检查服务列表Get-Service | Where-Object {$_.Name -like *claw* -or $_.DisplayName -like *OpenClaw*}找到服务后Stop-Service -Name OpenClawService -Force sc.exe delete OpenClawService清理计划任务OpenClaw可能有定时更新或保活任务Get-ScheduledTask | Where-Object {$_.TaskName -like *claw* -or $_.TaskPath -like *openclaw*} | Unregister-ScheduledTask -Confirm:$false最后清理用户PATH环境变量里的OpenClaw条目。通过系统设置手动删除或者用PowerShell精确移除$oldPath [Environment]::GetEnvironmentVariable(Path, User) $newPath ($oldPath -split ; | Where-Object {$_ -notlike *OpenClaw* -and $_ -notlike *claw*}) -join ; [Environment]::SetEnvironmentVariable(Path, $newPath, User)注意过滤条件别把C:\Windows\System32之类的关键路径也过滤掉。稳妥起见先把原Path打印出来自己过目一遍再过滤。还有注册表残留。这个我不推荐新手手动乱改除非你很确定。可以用reg query查找相关键但单纯为了卸载OpenClaw去动注册表风险大于收益。只要进程、文件、服务、计划任务、PATH都清干净了那一两个空注册表项对系统没有影响。6. 常见残留问题与排查技巧实录6.1 卸载后命令还在八成是PATH里有多个副本我遇到过一个很经典的情况卸载后执行claw --version依然能输出而且which claw指向的还是已删除的路径。这让你百思不得其解。后来排查才发现当时部署时脚本在~/.local/bin下也复制了一份可执行文件而官方卸载脚本只处理了/usr/local/bin。所以如果你遇到command not found预期落空的情况按这个顺序找type -a claw whereis claw ls -la ~/.local/bin/claw ~/.local/bin/openclaw /usr/local/bin/claw /usr/bin/claw 2/dev/null把每个结果都删一遍。还有注意shell的哈希缓存删完后执行hash -r不然bash可能还记着命令的旧路径导致你误以为文件没删掉。6.2 端口被占用如何确认是不是OpenClaw的残留进程OpenClaw默认会监听一个本地端口不同版本可能用6080、8080或者9000。卸载后端口还占用大概率是残留的server进程或者某个辅助容器。排查方法# Linux/macOS lsof -i :6080 netstat -tulpn | grep 6080找到PID后用ps -p PID -f查看进程详情确认和OpenClaw相关了就kill -9 PIDWindows下对应netstat -ano | findstr :6080 taskkill /F /PID PID如果端口查出来是Docker容器占用的就用上面Docker清理流程继续处理。这里提醒一下别看到一个端口被占用就不分青红皂白地杀掉可能那个端口是其他软件在用的。先看进程路径和名称确认是OpenClaw的残留再动手。6.3 卸载后日志还在疯狂写入是什么情况有次卸载完OpenClaw第二天发现/var/log下面多了一个openclaw文件夹而且还在不断增长。查了才发现原来是之前安装时给logrotate写了一个配置日志旋转脚本还在定时运行但OpenClaw已经不在了于是它一遍遍地创建空日志文件。清理办法sudo rm -rf /var/log/openclaw sudo rm -f /etc/logrotate.d/openclaw再看一下crontab -l里有没有相关日志清理任务一并删掉。这种问题在Linux下特别容易出现因为安装脚本很喜欢往系统目录里塞各种配置文件卸载时又不管这些配置的死活。6.4 数据卷清理优先级先备数据再删程序最后删卷这是我处理过无数起事故后总结的铁律。很多朋友上来就把整个~/.local/share/openclaw包括Docker数据卷一气呵成地删了然后发现某一天想迁移到另一台机器、或者回滚到旧版本结果找不回任何配置。我的建议顺序永远是备份一切配置、数据、数据库、导出文件。停止并删除程序本体可执行文件、源码目录、系统服务。最后清理数据目录和数据卷。顺序反了神仙也救不回来。哪怕你确认百分之百不会再用了也建议在备份目录里留一个压缩包注意保护其中token、密钥等敏感信息不要上传到公网本地留着就好。7. 终极建议如何避免下一次卸载失败7.1 安装前先看一手卸载脚本很多人装OpenClaw就是一条命令复制粘贴跑完压根不看脚本内容。等到卸载出问题才后悔当初没留点心。我建议每条安装命令都先下载脚本内容用less或编辑器看一下重点看三块安装到了什么目录、是否注册了systemd或launchd服务、是否修改了shell配置。了解这些你卸载时基本就能预判残留位置。这个方法适用于任何工具不只是OpenClaw。7.2 安装完成后立刻建立部署档案别嫌麻烦安装成功后花两分钟写一个文件记录下安装方式一键脚本/Docker/手动编译安装日期和版本号可执行文件路径配置数据目录端口号服务名称这个档案可以直接存成DEPLOYMENT.md放在项目目录里。真到卸载那天照着档案一项项清比临时翻找省时间得多也大大降低漏删概率。7.3 能容器化就不裸装但数据卷要单独管理从卸载的角度Docker部署确实比裸装要干净因为它把程序进程和文件系统都隔离在容器里卸载时只需删容器和镜像。但代价是数据卷更隐蔽如果你不定时备份一旦docker compose down -v执行下去数据就是永久消失。所以我自己现在有一个习惯用Compose部署OpenClaw时数据卷目录一定显式映射到宿主机比如./data:/data这样卸载后我还能在项目目录里看到数据做最后销毁决定时心里有底。另外介于很多朋友在飞书、Teams里接入OpenClaw做Agent卸载前务必确认渠道侧的webhook和token已经解绑或者停用否则你机器上的服务停了渠道侧还在不断回调会报一堆连接错误。这个虽然不影响卸载但处理不好也够烦心的。这也是我在清理渠道配置channel时归纳出的经验先解除外部依赖再清理本地文件整个卸载过程才真正闭环。最后说点掏心窝的话OpenClaw卸载这种事官方命令救不了你的时候千万不要选择不管了反正重启就完事的路子。残留的守护进程、脏数据、被改坏的环境变量都会在下一次安装或者运行其他工具时变成一颗雷。我这套手动清理的方案看起来步骤多但每一条都是被实际现场验证过的。你只要对照自己的安装方式按顺序花十几分钟走一遍系统就能回到安装之前的状态。别急着偷懒处理干净了以后再装回来心里也踏实。
