Windows 下 OpenClaw 彻底卸载指南：清进程、删残留、除配置

OpenClaw 这阵子在玩本地 AI Agent 的朋友圈里出镜率相当高不少人都是看到一篇部署教程就跟着在 Windows 上装了一套。跑起来确实香能接飞书、Teams还能把千问之类的模型丢进去当大脑用但真到不想要了想卸掉才发现这玩意儿比想象中能留坑。最常见的翻车现场是文件夹删了、图标没了结果命令行一敲 openclaw 还是能弹出个东西或者过几天发现某个端口被占、开机自启里有个幽灵进程又或者重装时被 “session file locked” 这种报错卡住。这篇教程就是为“彻底卸载”这件事写的我会把 OpenClaw 在 Windows 上所有可能残留的位置一个一个过一遍。不管你是用 Python 环境装的还是 Docker 跑起来的又或者干脆是装在 WSL 子系统里的按下面的步骤操作基本能还你一个干净系统。教程不需要你懂多深的技术细节跟着命令一条条执行就行每一步终端里应该出现什么反馈我也都写明白了。1. 卸载前的准备工作1.1 先判断你的 OpenClaw 是通过哪种方式装进来的OpenClaw 在 Windows 上最常见的安装方式有四种用 pip 装的 Python 包、通过 uv 或 pipx 这类工具安装的独立命令行程序、用 Docker 容器跑的、以及放在 WSL 的 Linux 发行版里跑的。不同方式的卸载路径差别很大如果上来就乱删很容易出现“主体没了尸体还在”的情况。先花两分钟判断一下安装方式。打开终端WinR 输入 cmd 或直接打开 PowerShell逐条执行下面的命令openclaw --version pip show openclaw pip list | findstr /i claw docker ps -a wsl -l -v看到什么输出了就知道大概方向了。我把常见结果和对应结论整理成了一个表格方便你对照命令典型输出判断结论openclaw --version显示例如 0.4.2 之类的版本号全局命令还在 PATH 里需要处理环境变量openclaw --version提示“不是内部或外部命令”PATH 里没有命令或已经卸过主体pip show openclaw显示包名、版本、安装路径通过 pip 或 Python 虚拟环境安装pip list | findstr /i claw显示 openclaw、open-claw 等包名可能不完全是 openclaw搜索要放宽docker ps -a有包含 openclaw 的容器Docker 方式运行要清容器和镜像wsl -l -v显示 Ubuntu 等发行版可能在 WSL 里需要进子系统处理如果上面命令全都查不到也别急着松口气OpenClaw 有可能是“用户级安装”的独立程序放在当前用户目录下外面根本看不出命令痕迹。这种情况重点找安装目录就行后面 2.4 会讲。判断方式不重要重要的是别在卸载前把自己的配置和会话数据弄丢这就引到下一节了。1.2 备份数据哪些文件夹值得先保存很多人会想卸载还要备份确实普通软件卸载也就删了但 OpenClaw 这类本地 Agent 工具不太一样它会在系统里存不少“有价值的东西”你跟 agent 的历史会话记录、你精心调过的 prompt 模板、接入飞书和 Teams 时的 channel 配置、它积累下来的记忆文件都在本地目录里。下次如果重装这些东西能直接复用省去重新对接模型和调 prompt 的时间。所以动任何删除命令之前先备份下面这些位置%USERPROFILE%\.openclaw主配置目录包含 config、sessions、memory 等%APPDATA%\OpenClaw应用数据目录存放 token 缓存、日志%LOCALAPPDATA%\OpenClaw缓存和临时文件也可一并备份如果你的项目文件夹里还有.openclaw或者openclaw_data同样要备份备份不需要太复杂直接压缩就行。也可以在终端里执行 Robocopy把整个目录复制到其他盘robocopy %USERPROFILE%\.openclaw D:\backup\openclaw_backup /E实测下来 Robocopy 比普通复制靠谱碰到长路径或者奇怪权限也不会半路卡住。备份完顺手再确认一下目标目录里有东西别复制一半就以为自己备份过了。数据这块宁多勿少反正也不占多少空间删了就真的没了。1.3 先把所有关联进程全部关掉这一步是很多人会踩坑的地方卸载 OpenClaw 之前没有停掉进程导致文件被占用、配置目录删不掉甚至残留一堆 session 锁文件。尤其是用 Docker 跑过 OpenClaw 的容器没停就直接去删镜像后面各种报错。先查一下有没有相关进程在跑tasklist | findstr /i openclaw如果查不到 openclaw.exe 这种直接同名的不代表没事。OpenClaw 在本地往往是用 node.exe 或者 python.exe 跑起来的进程名不一定暴露身份。更准确的办法是看命令行里是否包含 openclaw 关键字在 PowerShell 里执行Get-CimInstance Win32_Process | Where-Object { $_.CommandLine -match openclaw } | Select-Object ProcessId, Name, CommandLine有输出的话就记下对应的 PID然后结束掉taskkill /F /PID 这里填查到的PID如果 Docker 容器还在跑先看容器列表docker ps --filter nameopenclaw然后执行docker stop 容器ID把容器停掉。到这里卸载前的准备工作就做完了安装方式心里有数了数据备份了进程全部停干净了。接下来动手卸载才算安全。2. 核心卸载实操把主程序从系统里摘掉2.1 Python / pip 环境下的卸载如果你的 OpenClaw 是通过 pip 安装的卸载其实很简单难的是把伪装成各种名字的包都揪出来。先别看名字以为只有 openclaw 一个实际项目里包名可能是open-claw、openclaw-agent、claw等变体所以第一步先宽口径搜索pip list | findstr /i claw找到准确包名之后执行卸载pip uninstall openclaw -y如果你当初是通过 uv 或 pipx 这类工具安装的独立命令行版本直接用 pip 卸载是没用的因为它们会把程序放到自己的隔离目录里。正确做法是uv tool list uv tool uninstall openclaw pipx list pipx uninstall openclaw这里特别提醒一点你大概率不止一个 Python 环境。系统里可能既有 Anaconda、又有 pyvenv 虚拟环境还有 uv 默认环境。卸载时只在一个环境里执行是不行的得把可能装了 OpenClaw 的环境都过一遍。我自己的习惯是写个小循环把所有 conda env 都查一遍反正也就多敲几行命令。如果哪条命令提示“找不到这个包”那就直接跳过。还有一些发行版把 OpenClaw 打成了带 GUI 的 launcher 形式卸载完命令行工具后开始菜单里可能还留着一个 “OpenClaw Launcher” 的入口。这只是快捷方式真正要处理的是它背后的卸载程序一般在%LOCALAPPDATA%\Programs\OpenClaw\Uninstall*.exe这种路径下双击运行即可。如果找不到专门的卸载 exe就直接跳到 2.4 删整个主程序目录。2.2 Docker 容器、镜像和卷的清理Docker 方式跑 OpenClaw 的情况比较特殊它表面上只有一个容器但背后往往带着镜像、数据卷、自定义网络三样东西。很多人只删了容器结果镜像还占着几个 GB 的空间匿名卷里的旧会话数据还会在下次安装时莫名其妙“复活”。先把所有相关容器列出来注意加过滤条件不然一堆容器里很难找docker ps -a --filter nameopenclaw把容器 ID 记下来执行停止和删除docker stop 容器ID docker rm 容器ID如果你想偷懒容器在运行状态下也是可以直接强制删的docker rm -f 容器ID一步到位。但建议还是先 stop 再 rm给 OpenClaw 一个正常的退出流程不然会话文件可能留下锁。接下来处理镜像docker images | findstr /i openclaw docker rmi 镜像ID如果提示镜像被某个容器引用删不掉说明刚才容器没有删干净再执行docker ps -a检查一遍。然后是重头戏——数据卷。OpenClaw 的配置和会话数据经常写在匿名卷里不删卷等于没卸。查看和删除docker volume ls | findstr /i openclaw docker volume rm 卷名有 compose 文件的话更简单切到 compose 文件所在目录直接一条命令连容器带卷全清掉docker compose down -v-v参数的意思就是连 volume 一起删。这里我踩过一次坑第一次只删了容器和镜像没理卷结果重装后 agent 还能“回忆”起以前的会话记录一时以为自己误触了什么云同步功能其实就是卷里的数据残留。2.3 WSL 子系统里的清理不少人是先在 Windows 上装好了 WSL然后跑到 Ubuntu 这种发行版里部署 OpenClaw。如果你也是这种玩法卸载时千万别只在 Windows 侧删几个快捷方式就完事真正的主角在 Linux 里。先确认有哪些 WSL 发行版wsl -l -v如果发现 Ubuntu 之类的发行版里装了 OpenClaw进子系统卸载wsl -d Ubuntu --user root -- bash -c pip uninstall openclaw -y rm -rf /root/.openclaw这条命令的意思是以 root 身份进入 Ubuntu卸载 pip 包并删除配置目录。如果你在子系统里还有其他用户比如用户名是 joe那么配置目录通常在/home/joe/.openclaw对应清理也要替换路径。要是这个 WSL 发行版只是专门为了跑 OpenClaw 而建的里面已经没有别的东西了也可以干脆把整个发行版注销掉一步到位wsl --unregister Ubuntu这个命令会把整个子系统连同里面全部文件一起抹掉执行前千万确认不需要里面的东西了。我见过有人手滑把用了半年的开发环境直接注销当场心疼得拍桌子。2.4 直接删除主程序安装目录如果你是用“免安装版”或者安装型程序部署的那还需要手工删主目录。常见安装位置如下C:\Program Files\OpenClaw%LOCALAPPDATA%\Programs\OpenClawC:\OpenClaw当前用户目录下的openclaw文件夹用管理员身份打开 PowerShell 或 CMD逐个删除rmdir /s /q C:\Program Files\OpenClaw/s是递归删除子目录/q是不再逐条确认配合起来就是静默全删。如果提示“无法删除正在被使用”那大概率是 1.3 节没做彻底还有 node.exe、python.exe 在后台跑着 OpenClaw 相关模块。回去再执行一次进程检查不要头铁硬删。如果你的安装方式特殊不确定主程序在哪里就靠 Windows 上广撒网的搜索方式处理。装上 Everything直接搜 openclaw 关键字把所有路径列出来再逐一判断。搜索的时候注意路径别把别的软件里恰好叫 OpenClaw 的组件也当成目标看路径是否包含 openclaw 项目目录。宁可多问一句“这个目录是干嘛的”也好过误删系统组件。3. 深层清理配置目录、环境变量、启动项与注册表3.1 配置、缓存与数据目录逐个清主体删完后剩下的才是真正决定“彻不彻底”的部分。OpenClaw 会往系统里撒一堆配置文件、缓存和日志散落在不同目录。下面这些路径逐个检查存在的就删掉%USERPROFILE%\.openclaw%APPDATA%\OpenClaw%LOCALAPPDATA%\OpenClawC:\ProgramData\OpenClaw%TEMP%下所有名字含 openclaw 的文件或文件夹删除命令示例rmdir /s /q %USERPROFILE%\.openclaw rmdir /s /q %APPDATA%\OpenClaw rmdir /s /q %LOCALAPPDATA%\OpenClaw如果你之前做了备份把这些目录全删了也不用心疼。如果没备份先暂停两分钟把这几个目录压缩保存一下再删。还有一个容易漏掉的地方是%USERPROFILE%\.config\openclaw这是不少 CLI 工具默认读配置的位置也要顺手检查。我个人的经验是不要只盯着标准路径用 Everything 全局搜一下openclaw收尾最稳。搜出来几十个文件是正常的这里面既有安装残留、也有缓存文件只要确认路径不指向系统关键组件都可以放心清掉。唯一要注意的是别把库文件DLL按 CtrlA 全选删了看清楚每个文件所在目录再下手。3.2 环境变量PATH 和其他变量中的残留命令行里敲 openclaw 还能有反应十有八九是环境变量 PATH 里还留着指向安装目录的条目。这个不清理下次装新版本时可能会出现老版本命令和新版本工具互相干扰的怪毛病。检查一下当前 PATH 里有没有 openclawecho %PATH%或者在 CMD 里执行where openclaw如果还有输出说明 PATH 里确实残留了旧路径。打开环境变量编辑器有两种方式任选其一sysdm.cpl然后在“高级”选项卡里点击“环境变量”在“用户变量”和“系统变量”里找到 PATH双击编辑把包含 openclaw 的条目删掉点确定保存。除了 PATH还要检查有没有 OpenClaw 自定义的独立变量比如OPENCLAW_HOMEOPENCLAW_CONFIGOPENCLAW_DATA_DIR这些通常存在于用户变量或系统变量里直接在环境变量窗口里删掉即可。如果你懒得开图形界面也可以在注册表里直接动刀但风险高一点。位置是HKEY_CURRENT_USER\EnvironmentHKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment删注册表里的字符串值之前最好在 regedit 里先“导出”备份一下当前分支出问题也能还原。改完环境变量不会立刻全局生效最好注销重新登录一次或者干脆重启不然新开的终端里可能还是读到旧的值。3.3 快捷方式、自启动项和注册表残留开完机发现 OpenClaw 的进程又自己跑起来了这种经历估计不少人都有过。这背后的原因基本是开机自启动项、计划任务或者注册表 Run 键没清理。先删快捷方式。开始菜单和桌面两个位置都要查Get-ChildItem $env:ProgramData\Microsoft\Windows\Start Menu\Programs -Recurse | Where-Object { $_.Name -match openclaw } | Remove-Item Get-ChildItem $env:APPDATA\Microsoft\Windows\Start Menu\Programs -Recurse | Where-Object { $_.Name -match openclaw } | Remove-Item Get-ChildItem $env:USERPROFILE\Desktop -Recurse | Where-Object { $_.Name -match openclaw } | Remove-Item再检查开机自启动项。任务管理器切到“启动应用”标签页看到 OpenClaw 就右键禁用这里“禁用”只是让它下次开机不启动真正的删除还得去注册表。命令行查询reg query HKCU\Software\Microsoft\Windows\CurrentVersion\Run reg query HKLM\Software\Microsoft\Windows\CurrentVersion\Run如果看到包含 openclaw 的条目就删掉reg delete HKCU\Software\Microsoft\Windows\CurrentVersion\Run /v OpenClaw /f/v后面跟的“OpenClaw”要替换成你实际查到的值名称别照抄。然后是注册表全盘搜索。在 WinR 里输入 regedit打开后按 CtrlF 搜索 openclaw查到一个删一个再按 F3 继续找下一个。这个环节要有一点耐心OpenClaw 的键一般出现在Software\OpenClaw、Software\Classes、Software\Microsoft\Windows\CurrentVersion\Uninstall等位置。搜索前建议把注册表导出备份一次以防手抖删了不该删的。不想手动翻注册表的话用微软 Sysinternals 的 Autoruns 最省事。它能直接列出自启动项、计划任务、服务、驱动等所有开机加载项搜 openclaw 关键字后直接勾掉删除比手工查可靠得多。计划任务也别漏WinR 输入taskschd.msc打开任务计划程序找找有没有 OpenClaw 相关的触发器有就删。4. 验证卸载结果与常见问题排查4.1 怎么确认真的卸干净了卸载完成不等于收工我建议按下面这几条逐项核实一遍。我把它整理成表格每一项对应一个检查命令输出的结果判断标准也写清楚检查项命令通过标准命令入口openclaw --version提示“不是内部或外部命令”或者 command not foundPython 残留pip show openclaw无输出或提示 No matching distributionDocker 残留docker ps -a / docker images无 openclaw 相关容器和镜像配置目录dir %USERPROFILE%.openclaw路径不存在环境变量echo %PATH%不包含 openclaw开机进程重启后任务管理器无 openclaw、无相关 node/python 进程最靠谱的做法是重启一遍电脑再复查。有些文件之所以删不掉是因为系统服务还没释放句柄重启后才会恢复自由。而且在重启后的“干净状态”下你才能确认没有自启动项目把 OpenClaw 重新拉起来。4.2 session file locked 报错一个和卸载有关的坑网上不少人卸载后重新安装 OpenClaw结果一启动 agent 就报这个错误agent failed before reply: session file locked (timeout 60000ms)这是典型的“旧会话锁文件残留”问题。OpenClaw 在本地会把每次会话写入一个 session 文件并在文件上加一把锁。如果上一次进程没有正常退出、而是直接关掉终端或者拖了几个 agent 实例同时访问同一个 session 文件锁就不会及时释放下次启动就得竞争 60 秒超时后直接报错。解决思路很简单手工清掉锁文件。先去备份过的配置目录里找到 sessions 文件夹一般路径是%USERPROFILE%\.openclaw\sessions\把该目录下的.lock文件全部删掉del %USERPROFILE%\.openclaw\sessions\*.lock如果你重装时发现配置目录已经不存在那关于“session lock”的报错就没有出现的土壤了。除非你用的是 Docker 且没清理数据卷那我只能劝你回到 2.2 节把 volume 里残留的 sessions 一并删除。这个报错也提醒我们一件事日常使用 OpenClaw 时尽量别用 CtrlC 粗暴打断多给它一点正常退出的时间能少很多锁文件问题。4.3 文件占用、权限不足这类硬骨头卸载清理时最常见的尴尬就是“删不掉”。普通文件还好删不掉一般就是进程占用。用任务管理器把可疑的 node.exe、python.exe、docker 相关进程都查一遍找到命令行里带 openclaw 的直接结束。这里不要见 python 就杀得先确认路径否则误杀别的开发服务就得不偿失了。如果是权限问题右键直接用资源管理器删经常提示“需要 TrustedInstaller 权限”或者“拒绝访问”那是因为安装时用服务方式写入了一些受系统保护的位置。用管理员终端可以强行接管目录后再删takeown /f C:\Users\你的用户名\.openclaw /r /d y rmdir /s /q C:\Users\你的用户名\.openclawtakeown的作用是把目录所有者改成当前管理员加上/r表示递归所有子文件。遇到个别顽固文件也可以先重命名再删除绕过某些文件系统缓存问题。还有一记绝招是进安全模式再删在安全环境下基本没有第三方进程干扰删系统目录都格外顺手。需要提醒的是删除文件时一旦遇到“正在被某进程使用”的提示别迷信什么一键解锁工具。先试重启再删通常都能解决。如果你用的是 Windows 11文件资源管理器自带“可恢复删除”等逻辑一些系统关键文件删了可能有副作用所以每一条删除操作都量力而行。遇到不能确定归属的宁可不删也别乱删。写到这里这套卸载流程基本就完整了。我自己在 Windows 上前前后后装过两次 OpenClaw第一次卸载就吃了没先停进程的亏agent 还在后台跑着我直接把配置目录删了结果重装后各种跟锁相关的报错层出不穷后来是清完 sessions 里的锁文件才恢复正常。现在的习惯是无论卸载什么本地 AI 工具都先备份、再停进程、然后按“命令 服务 数据目录”三个维度去清最后检查一遍 PATH、启动项和注册表。这套思路其实可以平移到很多类似项目的卸载场景。按照这篇顺序操作下来应该能把 OpenClaw 的所有痕迹都收拾干净给系统一个清爽的交待。