Win11 彻底卸载 openclaw 教程：npm 全局包与终端残留清理

1. Win11 卸载 openclaw 为什么总卸不干净openclaw 这类工具在 Win11 上通常有两种安装路径一种是通过 npm 全局安装另一种是官方脚本iwr -useb https://openclaw.ai/install.ps1 | iex一键装。两种方式都会在系统里留下不同位置的痕迹——npm 全局包在 Node 的全局目录里脚本安装会额外注册计划任务、写入用户目录下的隐藏配置文件夹、生成日志。很多人卸载时只跑了npm uninstall -g openclaw结果重装时发现旧配置还在、端口被占用、计划任务还在后台跑。原因就是 npm 卸载只删了包本身配置目录、日志、计划任务、旧版遗留目录一个都没动。这篇教程聚焦 Win11 下用 npm 全局安装 openclaw 后的完整卸载流程从终端定位全局包路径开始到清理缓存与残留配置再到验证卸载是否干净。每一步都给可复制的命令和检查清单帮你避免重装冲突。如果你后续还要接入其他模型服务做编码或对话卸载干净是第一步后面我会顺带说下怎么用 TaoToken 把模型能力接回来。适合谁看在 Win11 上用 npm 装过 openclaw、现在想彻底清掉重装或换方案的人以及遇到openclaw --version还能跑但不知道包在哪的人。2. 卸载前先搞清楚 openclaw 装在哪动手删之前先定位。Win11 的终端分 PowerShell 和 CMD下面命令默认在 PowerShell 里跑Win X 选“终端管理员”。先看 npm 全局包根目录在哪npm root -g输出类似C:\Users\你的用户名\AppData\Roaming\npm\node_modules。openclaw 的包体就在这个目录下的openclaw或openclaw-cn文件夹里。再看全局可执行文件位置npm bin -gWin11 上一般返回C:\Users\你的用户名\AppData\Roaming\npm里面会有openclaw.cmd、openclaw.ps1这类启动脚本。确认当前装的是哪个版本npm list -g --depth0这条会列出所有全局包你能看到是openclaw还是openclaw-cn或者两个都在。我试过同时装原版和中国版的情况卸载时两个都要处理。检查计划任务是否存在schtasks /Query /TN OpenClaw Gateway如果返回任务信息说明脚本安装时注册了后台网关卸载时必须一起删。检查配置目录Test-Path $env:USERPROFILE\.openclaw Test-Path $env:USERPROFILE\.clawdbot Test-Path $env:USERPROFILE\.moltbot Test-Path $env:USERPROFILE\.molthub返回True的目录就是需要清理的。旧版遗留目录名不一样所以四个都要查。3. TaoToken 前置卸载后模型能力怎么接回来把 openclaw 清干净之后如果你还需要模型对话、代码补全或 Agent 类能力可以用 TaoToken 作为统一入口。它提供兼容 OpenAI 风格的 API也有 Claude Code 相关的接入方式适合在卸载旧工具后重新搭一套干净的调用链路。TaoToken 官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 基础地址不带 UTMhttps://taotoken.net/api几个常用 deep link按需取模型对话体验https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewriteCoding Plan长期编码/Agenthttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteClaude Code 接入https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite注意TaoToken 是模型调用入口不是编辑器替代品。它负责把请求转发到模型你的代码编辑、终端操作还是在本地工具里完成。拿到 API Key 后配置环境变量即可在终端里调用。下面给一个 PowerShell 设置示例$env:TAOTOKEN_API_KEY 你的APIKey $env:TAOTOKEN_BASE_URL https://taotoken.net/api验证 Key 是否可用curl.exe https://taotoken.net/api/v1/models -H Authorization: Bearer $env:TAOTOKEN_API_KEY返回模型列表 JSON 就说明通了。这一步和卸载 openclaw 是独立的但顺序上建议先卸干净再配新环境避免旧的环境变量或配置干扰。4. 可复制配置Win11 彻底卸载 openclaw 全流程下面按顺序执行每一步都有说明。全程在“终端管理员”里跑。4.1 停止并删除计划任务脚本安装会注册一个叫OpenClaw Gateway的计划任务先删它schtasks /Delete /F /TN OpenClaw Gateway如果提示找不到任务说明没注册过跳过即可。再删网关启动脚本Remove-Item -Force $env:USERPROFILE\.openclaw\gateway.cmd -ErrorAction SilentlyContinue-ErrorAction SilentlyContinue的作用是文件不存在时不报错方便批量执行。4.2 卸载 npm 全局包原版和中国版分别卸不确定装了哪个就都跑一遍npm uninstall -g openclaw npm uninstall -g openclaw-cn卸载后 npm 会移除全局目录下的包体和对应的.cmd/.ps1启动脚本。如果提示up to date或removed都算正常。4.3 清理 npm 缓存npm 缓存里可能还留着 openclaw 的 tarball清一下避免重装时用到旧包npm cache clean --force这条会清空整个 npm 缓存不只是 openclaw。如果你有其他项目依赖缓存加速可以跳过或者用npm cache verify做校验清理。4.4 删除配置、数据、日志目录这是最关键的一步npm 卸载不会碰这些目录# 主配置目录记忆、技能、API 密钥等 Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw -ErrorAction SilentlyContinue # 旧版遗留目录 Remove-Item -Recurse -Force $env:USERPROFILE\.clawdbot -ErrorAction SilentlyContinue Remove-Item -Recurse -Force $env:USERPROFILE\.moltbot -ErrorAction SilentlyContinue Remove-Item -Recurse -Force $env:USERPROFILE\.molthub -ErrorAction SilentlyContinue # 日志目录 Remove-Item -Recurse -Force $env:LOCALAPPDATA\openclaw-logs -ErrorAction SilentlyContinue Remove-Item -Recurse -Force C:\tmp\openclaw -ErrorAction SilentlyContinue-Recurse递归删子目录-Force强制删只读文件。$env:USERPROFILE和$env:LOCALAPPDATA是系统环境变量不用手动替换用户名。4.5 检查环境变量残留有些安装脚本会往用户环境变量里写OPENCLAW_*或把安装目录加进PATH。查一下Get-ChildItem Env: | Where-Object { $_.Name -like *OPENCLAW* -or $_.Name -like *CLAW* }如果有输出用Remove-Item Env:变量名删掉当前会话的。永久变量要去“系统属性 → 环境变量”里手动删或者用[Environment]::SetEnvironmentVariable(变量名, $null, User)4.6 检查 PATH 里的残留路径$env:PATH -split ; | Select-String -Pattern openclaw|claw如果匹配到 openclaw 相关目录说明 PATH 里还有残留需要从用户 PATH 里移除。查看当前用户 PATH[Environment]::GetEnvironmentVariable(PATH, User)把含 openclaw 的片段删掉后重新设置。这一步不做的话重装时可能出现命令冲突。5. 验证请求确认卸载是否干净删完之后逐条验证全部通过才算干净。检查命令是否消失openclaw --version openclaw-cn --version预期结果提示“无法将‘openclaw’项识别为 cmdlet、函数、脚本文件或可运行程序的名称”。如果还能输出版本号说明全局包没卸干净回到 4.2 重跑。检查计划任务是否删除schtasks /Query /TN OpenClaw* 2$null预期结果无输出或报错找不到任务。有输出说明任务还在回到 4.1。检查端口是否释放netstat -ano | findstr :18789预期结果无输出。有输出说明还有进程占用端口用tasklist | findstr PID找到进程再处理。检查配置目录是否已删Test-Path $env:USERPROFILE\.openclaw Test-Path $env:USERPROFILE\.clawdbot Test-Path $env:USERPROFILE\.moltbot Test-Path $env:USERPROFILE\.molthub预期结果全部返回False。有True就回到 4.4 重删。检查 npm 全局列表npm list -g --depth0预期结果列表里没有 openclaw 或 openclaw-cn。检查 npm 全局目录残留Get-ChildItem $(npm root -g) -Filter *claw*预期结果无匹配。有匹配说明包目录还在手动删Remove-Item -Recurse -Force $(npm root -g)\openclaw -ErrorAction SilentlyContinue Remove-Item -Recurse -Force $(npm root -g)\openclaw-cn -ErrorAction SilentlyContinue全部验证通过后重装就不会有旧配置冲突了。6. 本篇常见错排查6.1 npm uninstall 报 EPERM 权限错误Win11 上如果终端不是管理员删全局包可能报EPERM: operation not permitted。解决Win X 选“终端管理员”或者用管理员身份打开 PowerShell 再跑卸载命令。6.2 openclaw --version 还能跑但 npm list 里没有这种情况通常是 PATH 里还留着旧的启动脚本路径或者脚本被复制到了其他目录。用where.exe openclaw定位实际路径where.exe openclaw返回的路径就是残留位置手动删掉对应文件再从 PATH 里移除该目录。6.3 计划任务删不掉提示“拒绝访问”计划任务可能属于 SYSTEM 权限。用管理员终端跑schtasks /Delete /F /TN OpenClaw Gateway如果还不行打开“任务计划程序”图形界面手动删。6.4 端口 18789 被占用但找不到 openclaw 进程可能是其他程序占用了同端口。用netstat -ano | findstr :18789拿到 PID 后tasklist /FI PID eq 你的PID确认不是 openclaw 相关进程就不用管是的话用taskkill /F /PID 你的PID结束。6.5 重装后配置还是旧的说明配置目录没删干净。重点检查$env:USERPROFILE\.openclaw和$env:LOCALAPPDATA\openclaw-logs以及C:\tmp\openclaw。有些版本还会在%APPDATA%下写数据Test-Path $env:APPDATA\openclaw返回True就一起删。6.6 npm cache clean 后其他项目变慢npm cache clean --force会清空全部缓存下次装包要重新下载。如果不想影响其他项目可以只删 openclaw 相关缓存或者跳过这步因为 npm 卸载本身不会因为缓存导致重装冲突。7. 卸载干净后用 TaoToken 接回模型能力openclaw 清干净了如果你还需要模型对话、代码补全或 Agent 能力可以按第 3 节的配置把 TaoToken 接上。核心就两步在 API Keys 页面拿到 Key然后设置TAOTOKEN_API_KEY和TAOTOKEN_BASE_URL两个环境变量。需要长期跑编码任务或 Agent 的看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite只想先试试模型对话效果的去模型对话页https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite接入过程中遇到报错先查接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteKey 管理在https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite最后提醒一句卸载 openclaw 时最容易漏的是$env:USERPROFILE\.openclaw这个隐藏目录和OpenClaw Gateway计划任务。这两处不删重装十有八九会冲突。按第 5 节的验证清单逐条过一遍全绿了再装新东西。