OpenClaw Windows 完整卸载
装了用了一段时间,或者装坏了想重来,又或者就是单纯觉得这玩意占地方——不管哪种情况, 这篇教程帮你把 OpenClaw 从 Windows 系统里干干净净地移除掉。包含残留文件清理、注册表清理、Ollama 卸载可选项,以及「只卸 OpenClaw 保留 Ollama」的选择性卸载方案。 其实本来是不想写的,但是看到网友的发卸载V500的这种帖子,真的很搞笑,还是随手写一篇吧!
作者:吴佳浩
撰稿时间:2026-3-19
目录
- 卸载前须知
- 整体卸载流程概览
- Step 1:停止并移除 Gateway 服务
- Step 2:卸载 OpenClaw npm 包
- Step 3:清理配置文件与数据目录
- Step 4:清理环境变量(如有)
- Step 5:可选 — 卸载 Ollama 与本地模型
- Step 6:可选 — 卸载 Node.js
- Step 7:可选 — 卸载 scoop / uv / gh
- 验证:确认彻底卸载
- 选择性卸载方案速查
- FAQ:卸载踩坑
1. 卸载前须知
卸载之前花 30 秒看一下这个,省得后悔:
| 你想卸载的 | 会连带删掉什么 | 需要哪些步骤 |
|---|---|---|
| 只卸 OpenClaw | openclaw 命令、配置、workspace、桌面快捷方式 | Step 1 → 5 |
| 同时卸 Ollama | 本地所有模型文件(几十 GB!) | Step 1 → 5 → 6 |
| 完全清空,全部卸掉 | 包含 Node.js、scoop、uv 等全部工具链 | Step 1 → 9 |
⚠️ 重点提示:Ollama 模型文件默认存放在
C:\Users\{用户名}\.ollama\models,一个 35B 模型就占 约 20 GB。卸载前先确认要不要保留,不然删了就得重新下载。
2. 整体卸载流程概览
flowchart TD
A[" 开始卸载"] --> B["Step 1\n停止 Gateway 服务\n移除开机自启"]
B --> C["Step 2\nnpm uninstall -g openclaw\n移除命令行工具"]
C --> D["Step 3\n清理配置目录\n~/.openclaw\n~/clawd"]
D --> E["Step 4\n清理环境变量\n检查 PATH"]
E --> F{"还要继续卸?"}
F -- "是,连 Ollama 也卸掉" --> G["Step 5\n卸载 Ollama\n删除模型文件"]
F -- "是,连 Node.js 也卸掉" --> H["Step 6\n卸载 Node.js"]
F -- "不了,够了" --> I[" 验证卸载完成"]
G --> H
H --> J["Step 7\n可选:卸载 scoop/uv/gh"]
J --> I
style A fill:#1a1a2e,color:#fff
style I fill:#00aa55,color:#fff
style G fill:#c62828,color:#fff
3. Step 1:停止并移除 Gateway 服务
这一步必须最先做,否则后续删文件时服务还在跑,会提示「文件被占用」。
1-1. 停止正在运行的 Gateway 进程
如果你是在终端前台运行 openclaw gateway,直接按 Ctrl+C 终止即可。
如果你安装了系统服务(openclaw gateway install),用以下命令停止并删除:
# 停止服务
schtasks /End /TN "OpenClaw Gateway"
# 删除计划任务
schtasks /Delete /TN "OpenClaw Gateway" /F
验证:运行
schtasks /Query /TN "OpenClaw Gateway"应该报「找不到指定的任务」,说明删除成功。
1-2. 杀掉残留的 Node 进程
# 查找占用 18789 端口的进程
netstat -ano | findstr :18789
# 假设输出的 PID 是 12345,杀掉它
taskkill /PID 12345 /F
# 或者直接批量杀掉所有 openclaw 相关的 node 进程
Get-Process node | Where-Object { $_.MainWindowTitle -like "*openclaw*" -or $_.CommandLine -like "*openclaw*" } | Stop-Process -Force
4. Step 2:卸载 OpenClaw npm 包
# 卸载全局包
npm uninstall -g openclaw
# 验证
openclaw --version
# 应该报:openclaw : 无法将"openclaw"项识别为 cmdlet... 说明卸载成功
如果
npm uninstall报错,尝试用管理员 PowerShell 运行,或先找到安装路径手动删除:# 找到全局包安装位置 npm root -g # 输出类似:C:\Users\{用户名}\AppData\Roaming\npm\node_modules # 直接删除 Remove-Item -Recurse -Force "C:\Users\$env:USERNAME\AppData\Roaming\npm\node_modules\openclaw" Remove-Item -Force "C:\Users\$env:USERNAME\AppData\Roaming\npm\openclaw.cmd" Remove-Item -Force "C:\Users\$env:USERNAME\AppData\Roaming\npm\openclaw"
5. Step 3:清理配置文件与数据目录
这一步删除 OpenClaw 生成的所有配置、日志、会话记忆、workspace 等数据。
graph TD
A["OpenClaw 遗留文件"] --> B["~\\.openclaw\\\n配置文件目录\nopenclaw.json\ntoken\n日志等"]
A --> C["~\\clawd\\\n默认 workspace\nAgent 工作文件"]
A --> D["桌面\nOpenClaw.url\n快捷方式"]
A --> E["临时 Modelfile\nF:\\Modelfile\n或其他路径"]
style A fill:#1a1a2e,color:#fff
style B fill:#c62828,color:#fff
style C fill:#c62828,color:#fff
3-1. 删除配置目录
# 先看看里面有什么(可选,确认一下再删)
Get-ChildItem "$env:USERPROFILE\.openclaw" -Force
# 删除整个配置目录
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
# 验证
Test-Path "$env:USERPROFILE\.openclaw"
# 输出 False
3-2. 删除 Workspace 目录
# 默认 workspace 路径
Remove-Item -Recurse -Force "$env:USERPROFILE\clawd"
# 如果你在 openclaw.json 里自定义了 workspace 路径,改成对应路径
# 比如 C:\AIWorkspace
Remove-Item -Recurse -Force "C:\AIWorkspace"
⚠️ 注意:workspace 里可能有 Agent 帮你生成的有用文件(代码、文档等),删之前先确认一下!
3-3. 删除桌面快捷方式
# 删除桌面快捷方式(如果建过的话)
Remove-Item -Force "$env:USERPROFILE\Desktop\OpenClaw.url" -ErrorAction SilentlyContinue
3-4. 删除临时 Modelfile
# 如果按教程在 F 盘创建了 Modelfile
Remove-Item -Force "F:\Modelfile" -ErrorAction SilentlyContinue
6. Step 4:清理环境变量(如有)
大部分情况下 npm 全局包不会单独写环境变量,但安装脚本有时候会,检查一下:
# 查看用户级 PATH,确认没有 openclaw 相关路径
[System.Environment]::GetEnvironmentVariable("PATH", "User") -split ";" | Where-Object { $_ -like "*openclaw*" }
# 如果有输出,说明需要手动清理
# 打开系统环境变量编辑界面
rundll32 sysdm.cpl,EditEnvironmentVariables
在弹出的界面里,找到「用户变量」→「Path」,双击编辑,删掉包含 openclaw 的条目。
7. Step 5:可选 — 卸载 Ollama 与本地模型(我个人不建议删除)
如果你打算继续用 Ollama 搭配其他工具(如 Open WebUI、Dify 等),跳过这一步。
5-1. 先确认模型文件大小
# 查看模型占用了多少空间
(Get-ChildItem "$env:USERPROFILE\.ollama\models" -Recurse | Measure-Object -Property Length -Sum).Sum / 1GB
# 输出单位为 GB,比如 78.3 表示占用 78.3 GB
5-2. 删除通过 ollama create 创建的自定义模型
# 查看所有模型(包括自定义的 -32k 版本)
ollama list
# 删除自定义上下文版本(按教程创建的)
ollama rm qwen3.5-35b-32k
ollama rm qwen2.5-7b-32k
# ...其他 -32k 结尾的自定义模型
# 删除原始 pull 下来的模型(可选)
ollama rm qwen3.5:35b
ollama rm qwen2.5:7b
5-3. 卸载 Ollama 程序
# 方法一:通过 winget 卸载
winget uninstall Ollama.Ollama
# 方法二:控制面板手动卸载
# 开始菜单 → 设置 → 应用 → 搜索 Ollama → 卸载
5-4. 删除 Ollama 数据目录
# 删除模型文件(这才是大头,几十 GB)
Remove-Item -Recurse -Force "$env:USERPROFILE\.ollama"
# 验证
Test-Path "$env:USERPROFILE\.ollama"
# 输出 False
flowchart LR
A["ollama rm 自定义模型"] --> B["ollama rm 原始模型"]
B --> C["winget uninstall Ollama"]
C --> D["删除 ~/.ollama 目录"]
D --> E[" Ollama 完全移除\n释放 N GB 磁盘空间"]
style E fill:#00aa55,color:#fff
style D fill:#c62828,color:#fff
8. Step 6:可选 — 卸载 Node.js
如果你有其他项目用到 Node.js,跳过这一步。
# 方法一:winget 卸载
winget uninstall OpenJS.NodeJS.LTS
# 方法二:控制面板
# 设置 → 应用 → 搜索 Node.js → 卸载
卸载后清理 npm 缓存和全局配置:
# 删除 npm 全局目录残留
Remove-Item -Recurse -Force "$env:APPDATA\npm" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:APPDATA\npm-cache" -ErrorAction SilentlyContinue
# 验证
node --version
# 应该报:node : 无法将"node"项识别为 cmdlet...
9. Step 7:可选 — 卸载 scoop / uv / gh
卸载 scoop(及通过 scoop 安装的所有工具)
# 卸载 scoop 会连带删除所有通过 scoop 安装的工具(gh、ffmpeg 等)
scoop uninstall scoop
# 手动删除 scoop 目录(如果上面命令没完全清干净)
Remove-Item -Recurse -Force "$env:USERPROFILE\scoop" -ErrorAction SilentlyContinue
单独卸载 gh(GitHub CLI)
# 如果 gh 不是通过 scoop 装的
winget uninstall GitHub.cli
卸载 uv
# uv 没有独立的 uninstall 命令,直接删除
Remove-Item -Recurse -Force "$env:USERPROFILE\.cargo\bin\uv.exe" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:USERPROFILE\.uv" -ErrorAction SilentlyContinue
# 或者通过 PowerShell 找到 uv 路径
(Get-Command uv).Source
# 拿到路径后删掉对应文件
10. 验证:确认彻底卸载
运行以下命令,全部报「找不到命令」就说明卸干净了:
# 逐条运行,看看哪些还在
openclaw --version
ollama --version # 如果你选择了卸载 Ollama
node --version # 如果你选择了卸载 Node.js
# 确认目录已删除
Test-Path "$env:USERPROFILE\.openclaw" # 应输出 False
Test-Path "$env:USERPROFILE\clawd" # 应输出 False
Test-Path "$env:USERPROFILE\.ollama" # 如卸载 Ollama,应输出 False
# 确认端口已释放
netstat -ano | findstr :18789
# 无输出 = 端口已释放
graph TD
A["验证清单"] --> B{"openclaw 命令?"}
B -- "找不到命令 " --> C{"~/.openclaw 目录?"}
B -- "还能运行 " --> B2["重新执行 Step 2"]
C -- "不存在 " --> D{"~/clawd 目录?"}
C -- "还存在 " --> C2["重新执行 Step 3"]
D -- "不存在 " --> E{"18789 端口?"}
D -- "还存在 " --> D2["重新执行 Step 3"]
E -- "无占用 " --> F[" 卸载完成!"]
E -- "还在监听 " --> E2["重新执行 Step 1\n杀掉残留进程"]
style F fill:#00aa55,color:#fff
style B2 fill:#c62828,color:#fff
style C2 fill:#c62828,color:#fff
style D2 fill:#c62828,color:#fff
style E2 fill:#c62828,color:#fff
11. 选择性卸载方案速查
根据你的实际需求,快速找到需要执行哪些步骤:
| 场景 | 需要执行的步骤 | 预计释放空间 |
|---|---|---|
| 只卸 OpenClaw,保留 Ollama 和模型 | Step 1 → 2 → 3 → 4 | < 500 MB |
| 卸 OpenClaw + Ollama,保留模型文件 | Step 1 → 2 → 3 → 4 → 卸 Ollama 程序 | < 1 GB |
| 卸 OpenClaw + Ollama 全部(含模型) | Step 1 → 2 → 3 → 4 → 5 | 20 ~ 100 GB |
| 完全清空,什么都不留 | Step 1 → 2 → 3 → 4 → 5 → 6 → 7 | 全部 |
| 装坏了想重装(重置) | Step 1 → 2 → 3,然后重新安装 | 只删配置,保留工具 |
💡 重装提示:如果你是因为配置搞乱了想重头来,只需要执行 Step 1 + Step 3(删掉配置目录),Node.js 和 Ollama 都不用动,重新运行
openclaw onboard就能从头初始化。
12. FAQ:卸载踩坑
Q1:npm uninstall -g openclaw 报权限错误
原因:npm 全局目录权限问题。
解决:以管理员身份运行 PowerShell:
# 管理员 PowerShell 中运行
npm uninstall -g openclaw
Q2:删除 ~/.openclaw 报「文件正在被使用」
原因:Gateway 进程还在运行,占用了配置文件。
解决:先完整执行 Step 1,确认进程已杀掉,再删目录。
# 强制查找并杀掉所有相关 node 进程
taskkill /F /IM node.exe
# 然后再删
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
Q3:schtasks /Delete /TN "OpenClaw Gateway" 报「找不到指定的任务」
原因:你可能没有用 openclaw gateway install 安装过服务,只是手动前台运行的。
解决:不用管,直接跳过,进行下一步即可。
Q4:卸载后 node --version 还能运行
原因:winget 卸载有时不会立即更新 PATH,需要重启终端。
解决:
# 关闭当前 PowerShell 窗口,重新打开一个新窗口
# 或者强制刷新环境变量
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
Q5:想保留聊天记录和会话记忆,怎么备份再卸载?
# 先备份整个配置目录到桌面
Copy-Item -Recurse "$env:USERPROFILE\.openclaw" "$env:USERPROFILE\Desktop\openclaw_backup_$(Get-Date -Format 'yyyyMMdd')"
# 备份 workspace
Copy-Item -Recurse "$env:USERPROFILE\clawd" "$env:USERPROFILE\Desktop\clawd_backup_$(Get-Date -Format 'yyyyMMdd')"
# 然后正常执行卸载流程
Q6:Ollama 删了模型,磁盘空间没有立刻释放
原因:Windows 资源管理器刷新延迟,或者有些碎片文件没删干净。
解决:
# 强制删除 .ollama 目录(如果 ollama rm 没删干净)
Remove-Item -Recurse -Force "$env:USERPROFILE\.ollama"
# 再运行一次磁盘清理
cleanmgr /d C:
总结
graph LR
A["卸载完成 "] --> B["端口 18789 已释放"]
A --> C["openclaw 命令已移除"]
A --> D["配置目录已清理"]
A --> E["可选:Ollama 已卸载\n释放 N GB 空间"]
A --> F["可选:Node.js 已卸载"]
style A fill:#00aa55,color:#fff
卸载流程对比安装要简单不少,核心就三步:停服务 → 删包 → 删文件。Ollama 和模型文件那坨是最占地方的,要不要删自己决定。
如果后续想重装,按安装教程从头来就行,Ollama 和模型不用重新下载,只需要重跑 openclaw onboard 重新初始化配置就够了。