OpenClaw Windows 完整卸载

0 阅读7分钟

OpenClaw Windows 完整卸载

391c1ad73ceb42829a8df25e42592a7b.png

装了用了一段时间,或者装坏了想重来,又或者就是单纯觉得这玩意占地方——不管哪种情况, 这篇教程帮你把 OpenClaw 从 Windows 系统里干干净净地移除掉。包含残留文件清理、注册表清理、Ollama 卸载可选项,以及「只卸 OpenClaw 保留 Ollama」的选择性卸载方案。 其实本来是不想写的,但是看到网友的发卸载V500的这种帖子,真的很搞笑,还是随手写一篇吧!

作者:吴佳浩

撰稿时间:2026-3-19


目录

  1. 卸载前须知
  2. 整体卸载流程概览
  3. Step 1:停止并移除 Gateway 服务
  4. Step 2:卸载 OpenClaw npm 包
  5. Step 3:清理配置文件与数据目录
  6. Step 4:清理环境变量(如有)
  7. Step 5:可选 — 卸载 Ollama 与本地模型
  8. Step 6:可选 — 卸载 Node.js
  9. Step 7:可选 — 卸载 scoop / uv / gh
  10. 验证:确认彻底卸载
  11. 选择性卸载方案速查
  12. FAQ:卸载踩坑

1. 卸载前须知

卸载之前花 30 秒看一下这个,省得后悔:

你想卸载的会连带删掉什么需要哪些步骤
只卸 OpenClawopenclaw 命令、配置、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 → 520 ~ 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 重新初始化配置就够了。


文档版本2026年3月(吴佳浩 整理,配套 OpenClaw Windows 完整安装教程)

配套阅读OpenClaw Windows 完整安装与本地模型配置教程(实战版)