你们圈子里管 OpenClaw 叫什么“龙虾”。确实这玩意儿的 logo 像只张牙舞爪的爪子部署起来脾气也像龙虾一样又倔又横。装的时候有多爽卸的时候就有多痛苦。今天这篇就是一份面向 2026 年环境的 OpenClaw 完整卸载指南目标是让这台机器跟你没装过它之前一模一样甚至更干净。我会把我实测踩过的坑、删不掉的注册表、无处不在的环境变量、以及那些偷偷藏在 Docker 卷里的投票数据一次性全部交代清楚。这不是一份简单的“右键卸载.exe”流程因为 OpenClaw 的架构注定了它会往系统里塞进一堆“孤儿进程”。它驱动的 agent 进程、驻留的 channel 监听服务、缓存的 session 文件如果不按正确顺序处理轻则留下一堆僵尸进程吃内存重则让它在你下次开机时自动复活——是的它真的会复活因为我见过 systemd 里残留的 service 文件把整个 agent 又拉起来继续跑然后卡在 “agent failed before reply: session file locked (timeout 60000ms)” 这个破问题上循环报错。全文围绕 Windows 和 Linux 环境为主macOS 的用户也基本适用只是一些目录路径不同我会在对应章节单独标注。适合谁看刚接触 OpenClaw 发现不合适想退回旧方案的人、接手了别人留下的 OpenClaw 服务器需要彻底清场的人、还有那种只是“看着像卸载了但强迫症想知道有没有残余文件”的人。内容比较长建议你先收藏动手卸载时候对着一步一步操作。1. 卸载之前先想清楚你要保存什么很多人一上来就执行pip uninstall openclaw或者rm -rf删到一半才想起来里面有几百条人设 memory、飞书/Teams 的 webhook 地址、以及花了一整晚调教好的 prompt 模板。这些东西删了就是永久没了OpenClaw 的配置目录和组织内部数据默认不跟随主程序安装包走我想帮你避免那种拍大腿的时刻。1.1 备份清单哪些文件值得留一手OpenClaw 的本地数据范围其实挺明显的关键是先摸清自己到底部署在哪个目录下。我见过太多人装的时候用了默认路径卸载的时候却去找自己自定的目录结果以为清干净了实际上数据全留在原地。默认情况下你需要关注这几个位置内容Windows 路径Linux/macOS 路径全局配置文件C:\Users\你的用户名\.openclaw\config.json~/.openclaw/config.json会话与记忆数据C:\Users\你的用户名\.openclaw\sessions\~/.openclaw/sessions/渠道通道配置C:\Users\你的用户名\.openclaw\channels.json~/.openclaw/channels.json日志文件C:\Users\你的用户名\.openclaw\logs\~/.openclaw/logs/Docker 挂载数据取决于你映射到哪里/var/lib/docker/volumes/openclaw_*如果你是通过我当时用的“一键部署”脚本装的它可能在当前目录建立一个.openclaw隐藏文件夹也可能在$HOME下建立两种情况我都碰到过。稳妥起见卸载前先做一次全盘检索把名称里带openclaw或claw的目录列出来看看心里有底再动手。# Linux/macOS 下检索 find / -iname *openclaw* -o -iname *clawdbot* 2/dev/null | grep -v proc # Windows 下用 PowerShell Get-ChildItem -Path C:\ -Filter *openclaw* -Recurse -Force -ErrorAction SilentlyContinue | Select-Object FullName这条命令第一次跑可能有点慢挂在 SSD 上也就一两分钟的事。搜出来之后别急着删先把config.json和channels.json复制到你的移动硬盘或者对象存储里。这两个文件是 OpenClaw 的“大脑”里面包含了所有渠道对接的凭据、模型 API key千问、GPT 或者其他的读取配置、agent 人设的基础设定。哪怕你以后再也不碰 OpenClaw把接口凭据留着自己管理也没坏处。1.2 停掉正在运行的实例防止“卸载到一半又复活”OpenClaw 最恶心的特性之一就是它的 agent 服务支持自动重启策略。如果你用 systemd 或者 NSSMWindows 下的服务安装工具把它注册为系统服务不先停服务直接删文件系统会在几秒内用旧配置把文件重新拉起来甚至在你已经删除可执行文件之后残留的.service文件依然会向你报错而不是彻底消失。正确的第一步是停服务、杀进程、杀守护进程顺序不能反。# Linux systemd 环境 sudo systemctl stop openclaw.service sudo systemctl disable openclaw.service # 防止开机自启 # 若通过 supervisor 管理 sudo supervisorctl stop openclawWindows 环境下如果你是通过sc create或者 NSSM 安装的服务用管理员权限的 PowerShell 执行# 停掉并删除服务 Stop-Service -Name openclaw -Force sc.exe delete openclaw # 若是 NSSM 注册的服务 nssm stop OpenClaw nssm remove OpenClaw confirm之后打开任务管理器检查所有带 OpenClaw 或者claw字样的进程手动结束还在死撑的残留进程。注意看有没有node、python进程挂着奇怪的命令行参数比如带有openclaw路径的那种一概杀掉。这个动作看着粗暴但确实是避免后面“删了又出现”的唯一有效手段。2. 分平台卸载主程序别让自己输在第一步主程序的卸载逻辑其实不复杂但 Windows 和 Linux 完全是两条路线很容易混。我之前在 Windows 上把 pip 的卸载命令用到了巨坑的 dev 环境里结果卸了半天发现那只是项目依赖并非本体。2.1 Windows 下的主程序与注册表清理如果你是通过 pipx 或者 pip 安装的 OpenClaw Python 发行版卸载用标准命令pip uninstall openclaw -y或者如果用的是 pipxpipx uninstall openclaw这里我特别想提醒一句OpenClaw 这个项目的更新频率极高Python 环境里极有可能残留着多个旧版本的依赖包。即使主程序卸载成功像openclaw-core、claw-utils这类相关名称的包也可能还留在 site-packages 里。执行以下命令做二次检查pip list | findstr /i claw pipx list | findstr /i claw如果发现残留一个个手动卸载别用pip uninstall不带包名这种迷惑操作。接着是注册表。OpenClaw 官方安装路径下会写入当前用户目录的软件信息不清理注册表虽然不影响运行但会留下“安装残留”的痕迹下次装新版本时可能被安装器检测到“已安装”而中断。用Win R打开regedit导航到以下两个路径删除和 OpenClaw 相关的项HKEY_CURRENT_USER\Software\OpenClaw HKEY_LOCAL_MACHINE\SOFTWARE\OpenClaw务必提前备份注册表或者创建还原点。这步操作如果失误可能影响系统里其他软件的运行。有时候你还能在“控制面板-程序和功能”里看到 OpenClaw右键卸载即可。这个卸载器会执行一部分残留清理但绝不会清理干净后面的章节才是重头戏。2.2 Linux 与 macOS卸载三类二进制文件Linux 下 OpenClaw 的发行形式非常杂有通过curl | bash安装的二进制包有通过 Docker 容器跑的镜像还有通过 pip 安装的 Python模块。你得先回忆一下自己当初是怎么装的或者执行which openclaw看它到底指向哪里再决定卸载路径。如果是二进制包直接删除对应路径即可which openclaw # 输出类似 /usr/local/bin/openclaw sudo rm -f /usr/local/bin/openclaw同时检查用户目录下的.local/bin和/usr/bin确保没有第二个副本。如果which没有输出但命令能跑可能是被 npm 或 pnpm 全局安装的此时用npm uninstall -g openclaw/cli pnpm remove -g openclaw/climacOS 用户则多检查一层 Homebrewbrew uninstall openclaw brew cleanup openclaw还要记得删除 shell 配置文件里手写的 alias 或者 PATH 追加项。这个过程通常被忽略但如果不删下次打开终端会看到一行烦人的command not found: openclaw报错。3. 配置文件与残留目录真正的“看不见的垃圾”主程序卸载干净后OpenClaw 那套运行期间产生的数据目录才是大多数人清理不彻底的重灾区。这些目录平时隐藏得深名字不显眼长期占着几百 MB 到几个 GB 的磁盘空间。3.1 用户目录下的隐藏配置文件夹无论你用哪种方式安装只要运行过一次OpenClaw 就会在当前用户的主目录下创建一批隐藏档案。Windows 上的%APPDATA%、%LOCALAPPDATA%和用户目录Linux 下的~/.config、~/.local/share这些都是它的温床。我建议挨个看看再删免得误伤别的软件# Linux / macOS rm -rf ~/.openclaw rm -rf ~/.config/openclaw rm -rf ~/.local/share/openclaw rm -rf ~/.cache/openclaw # Windows PowerShell Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw Remove-Item -Recurse -Force $env:APPDATA\OpenClaw Remove-Item -Recurse -Force $env:LOCALAPPDATA\OpenClaw删除前再次确认备份已经完成因为rm -rf命令一旦执行就没有反悔药了。我曾经手滑把整个~/.config目录删掉导致其他 CLI 工具的配置全部清空花了一个下午重新配置惨痛教训。3.2 环境变量与 PATH 中残留的项OpenClaw 安装时会往环境变量里写入OPENCLAW_HOME、OPENCLAW_CONFIG_DIR等变量卸载后这些变量会变成悬空引用有些第三方工具会因此告警。Windows 用户在“系统属性-环境变量”里检查用户变量和系统变量看到名字中带“OPENCLAW”的直接删除同时检查 PATH 里的条目把指向 OpenClaw 安装地址的路径移除。命令行操作方式[Environment]::SetEnvironmentVariable(OPENCLAW_HOME, $null, User) [Environment]::SetEnvironmentVariable(OPENCLAW_CONFIG_DIR, $null, User)Linux 用户检查~/.bashrc、~/.zshrc、~/.profile、/etc/environment、/etc/profile.d/下所有文件和内容通常会有类似export OPENCLAW_HOME/opt/openclaw的行用sed精确删除或者干脆手动编辑。3.3 编辑器插件与 Shell 集成这个部分知道的人不多但 OpenClaw 官方推荐过一系列辅助插件比如在 VS Code 里的 “OpenClaw Snippets” 扩展在 JetBrains 系 IDE 里的 “Claw Assistant” 插件以及在~/.vimrc或~/.config/nvim/init.vim里添加的自动补全脚本。这些插件不卸掉即便核心程序已经没了集成环境中依然会冒出 OpenClaw 相关的弹窗提示或模板代码。VS Code 里可以直接搜扩展名卸载vim 里则需手动删除对应配置行。普通用户如果平时只靠命令行运行这节可以跳过但对“彻底”二字有执念的人这是必选项。4. 系统服务与自动启动项杜绝“春风吹又生”OpenClaw 的自动启动机制在不同操作系统上有不同马甲它可能是 systemd 服务、LaunchAgent、Windows 计划任务、Docker restart policy 里的unless-stopped。这些都是卸载后它会“诈尸”的原因。4.1 Linux 服务清理systemd 与 cron如果你用 systemd 部署过 OpenClaw 的监听服务那么即使主程序删干净服务文件还会留在/etc/systemd/system/或~/.config/systemd/user/。需要执行sudo systemctl stop openclaw sudo systemctl disable openclaw sudo rm -f /etc/systemd/system/openclaw.service sudo rm -f /etc/systemd/system/openclaw-agent.service sudo systemctl daemon-reload sudo systemctl reset-faileddaemon-reload是很多人会漏掉的步骤如果删了文件但忘了重新加载配置systemd 还会认为服务存在并持续向你推送失败的启动日志。reset-failed则是把那些 failed 状态的残留记录清掉让systemctl list-units里不再出现可疑条目。同时检查 crontabcrontab -l | grep -i claw # 若有无安装到当前用户检查 root sudo crontab -l | grep -i claw有就执行crontab -e手动删掉对应行。老版本 OpenClaw 特别喜欢用reboot来确保自己醒来这条不加检查就绪等于白卸。4.2 Docker 残留容器与镜像Docker 方式部署是 OpenClaw 社区很流行的选择因为它的依赖隔离做得极好但后果就是卸载时如果只执行docker rm镜像和卷还静静躺在磁盘上占空间。我见过有人开 40GB 的 OpenClaw 镜像残留在开发机上硬是把 SSD 塞爆了。正确的做法是# 先查容器 docker ps -a | grep openclaw # 再停再删容器 docker stop $(docker ps -aq --filter nameopenclaw) docker rm $(docker ps -aq --filter nameopenclaw) # 删除镜像 docker images | grep openclaw docker rmi $(docker images -q --filter reference*openclaw*) # 最后清卷这步最容易被忽略 docker volume ls | grep openclaw docker volume rm $(docker volume ls -q --filter nameopenclaw)如果启动时用了docker-compose.yml项目名称会作为前缀生成卷名比如openclaw_data或者projectname_data。针对这种情况建议直接用docker-compose -f /path/to/openclaw/docker-compose.yml down -v-v参数会连带删除由该 compose 文件创建的卷。没指定 compose 文件路径就乱执行可能导致删错卷务必确认路径再操作。4.3 Windows 计划任务与启动文件夹Windows 下除了服务OpenClaw 还可能通过“任务计划程序”注册自动启动任务。搜索 “OpenClaw” 或 “ClawUpdater”等名称右键禁用并删除。同时清理启动文件夹# 当前用户的启动文件夹 Remove-Item $env:APPDATA\Microsoft\Windows\Start Menu\Programs\Startup\OpenClaw* -Force # 所有用户的启动文件夹 Remove-Item C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp\OpenClaw* -Force注意如果 OpenClaw Tray 图标托盘程序安装过开机自启动项它在注册表里通常位于HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run键名为OpenClawTray或类似字样用 regedit 删除。5. 网络监听与端口占用给你的系统做个“体检”卸载完程序、清完文件和注册表还没结束OpenClaw 在运行期间可能长期监听某个本地端口比如 17890 或者 8890具体看你的配置文件同时它的 agent 会主动连接飞书、Teams 等外部服务。程序卸了但系统网络层面可能仍有残留监听痕迹。5.1 检查端口是否正常关闭运行下面的命令看曾经的监听端口是否被释放# Linux / macOS lsof -i :17890 lsof -i :8890 ss -tlnp | grep -E 17890|8890 # Windows netstat -ano | findstr 17890 tasklist | findstr PID号正常情况下卸载并清理服务后这些端口应该一无所获。如果你发现端口还在被占用大概率是背后有残留进程没杀干净回到第 1.2 节再查一遍。这里特别提醒OpenClaw 的 agent 可能通过随机端口对外通信不固定端口所以单检查已知端口还不够最好借助杀软或者系统防火墙查看哪类程序的连接记录还挂着 claw 相关进程名。5.2 防火墙规则残留OpenClaw 在首次运行申请联网权限时会在系统防火墙里写入入站/出站规则名字通常是“OpenClaw”或“OpenClaw Agent”。这些规则如果不删系统安全策略里会留下永久性的“允许本地进程访问任意网络”的放行项等同主动留了一个后门级别的豁口。Windows 下用管理员 PowerShell 删除所有匹配规则Get-NetFirewallRule -DisplayName *OpenClaw* | Remove-NetFirewallRuleLinux 下如果配置过 ufw 或 iptablessudo ufw delete allow 17890/tcp sudo iptables -L -n | grep openclaw顺手也在 hosts 文件里检查有没有做过指向本机的特殊解析很多教程会教人为了调试飞书回调把openclaw.local解析到127.0.0.1这个手动条目也该一并移除。6. 验证卸载是否彻底你的检查清单这一节教你怎么系统地证明“真的没了”。不用装额外软件纯靠系统自带命令几分钟就能扫出安装残留不用再靠感觉确认。6.1 可执行文件与包管理器索引打开终端或 PowerShell执行which openclaw type openclaw如果输出不是“not found”或“无法找到”说明核心执行文件还在继续按第二节路径查找。接着检查各包管理器索引中是否还有条目pip list 2/dev/null | grep -i claw npm list -g 2/dev/null | grep -i claw docker images | grep -i claw brew list 2/dev/null | grep -i claw全部输出为空算你在可执行层面的清理过关。6.2 服务与目录双维度复核再用系统命令跑一轮服务状态和文件搜索systemctl list-units --all | grep -i claw docker ps -a | grep -i claw ps aux | grep -i claw | grep -v grep ls -la ~/.openclaw 2/dev/null echo 仍有残留 || echo 目录已清 ls -la ~/.config/openclaw 2/dev/null echo 仍有残留 || echo 配置目录已清Windows 用户对应Get-Service | Where-Object {$_.Name -like *claw* -or $_.DisplayName -like *claw*} Get-Process | Where-Object {$_.ProcessName -like *claw*} Get-ChildItem $env:USERPROFILE -Filter *openclaw* -Force -Recurse对所有返回结果逐一清除。此时你的系统才算真正恢复了“未被 OpenClaw 染指”的状态。6.3 隐藏较深的日志与状态记录严格来说OpenClaw 在运行期间还会把一些运行日志写进系统级日志目录。Windows 上的“事件查看器-Windows 日志-应用程序”里会留来源为 “OpenClaw” 的记录Linux 上的~/.xsession-errors、/var/log/syslog或 journalctl 日志中也会有大量日志条目。这些条目无法直接删除操作系统日志机制限制但这块属于历史记录范畴不影响系统干净与否。只要程序本身没有残留即可。我这人强迫症会顺手把日志文件压缩后存个档再清空那部分文件不过建议普通用户不用做到这步。7. 常见问题与卸载疑难杂症实录卸载 OpenClaw 时你大概率会撞上一些奇奇怪怪的状态我把高频问题整理成速查表方便你对症下药常见报错或状况原因分析解决方案agent failed before reply: session file locked (timeout 60000ms)session 文件被未退出的 agent 进程锁死卸载时常见“卸不动”的元凶先杀全部 agent 进程删除 sessions 目录后再卸载顺序不能倒卸载后重启电脑OpenClaw 又出现了存在注册为 Systemd 或 Windows 计划任务的守护进程按第 4 节逐个清理服务、计划任务、启动文件夹pip uninstall openclaw报错“没有这个包”安装方式并非 pip而是二进制包或 Docker 镜像用which openclaw定位按对应方式卸载删除 Docker 容器时提示“volume is in use”容器虽然停止但还挂在卷上先docker rm -f 容器名再执行docker volume rm 卷名卸载后飞书群里还能收到旧 agent 的消息启动于飞书开放平台的机器人回调仍然指向本机地址去飞书开放平台后台删除机器人应用并检查 webhook 配置是否还有指向清理后磁盘空间没恢复日志、session、Docker 卷、pip 缓存没清干净执行pip cache purge、docker system prune -a、手动删除占位目录每个问题的根因都不相同但有一个共同规律只要你卸载时漏掉了一个服务配置后面所有步骤都会出现连锁反应。我以前用自动化脚本暴力清理过一次结果有些旧依赖包居然跟无害的共享库混在一起导致别的项目跑不起来了。从那以后我就改为“先拆进程再拆服务然后拆配置最后查网络”这种固定流程几次下来稳定得很。8. 安全版本与卸载后收尾建议这一节只有经验层面的建议没有其他意思。OpenClaw 在 2026 年的版本迭代中已经内置了openclaw uninstall子命令如果官方推荐使用这个命令先执行它准不会错它能自动清理一部分常规安装产生的文件和服务。但请注意这个内置命令的清理范围有限尤其是涉及到渠道 token、本地密钥、agent 历史会话这些数据它默认是不动的。所以你要做的是先跑官方卸载器再跑我这篇指南里的手动清理步骤。顺序不能反。官方卸载器可能在卸载过程中直接删除配置文件导致你的备份工作白做所以无论如何记得先备份。另外有几个收尾小习惯我强烈建议执行重置或清空浏览器里保存的 OpenClaw 控制台密码清理系统钥匙串macOS Keychain或 Windows 凭据管理器中由 OpenAI/千问/飞书等渠道保存的 token如果曾用 GitHub Action 或 CI/CD 部署 OpenClaw顺手把仓库里的 secrets 也删掉去你授权的各个开放平台飞书、Teams 等撤销应用的访问权限。这些安全动作才是“2026 安全版”里“安全”二字的真正含义。技术上的文件清理谁都能做到但凭据和权限的回收才是彻底告别它的关键。写到这里我顺手回忆了一下自己之前清空 OpenClaw 时那次翻车经历。当时以为卸载完万事大吉结果半个月后发现公司的飞书群机器人突然又自动回复了一条消息查到最后发现是当时还有个 agent 进程残留在另一台测试机上压根没被我发现。后来养成的习惯就是卸载完成后一定等到第二天再复查一次进程和端口确保没有“诈尸”现象。建议你也这么做尤其是生产环境稳一手比什么都重要。