很多朋友安装了OpenClaw（圈内俗称「大龙虾」）后，常会遇到这些糟心问题：想换版本重装，却发现旧配置阴魂不散；只删了安装文件夹，后台服务还在偷偷开机自启；终端敲openclaw命令依然能用，甚至重装后直接报错端口被占用……

究其根本，是OpenClaw在Windows系统中分为CLI命令行工具、Gateway网关服务、本地配置数据、包管理器缓存四大核心组件，只删其中一个根本清不干净。本文基于OpenClaw国内官方最新卸载规范，覆盖一键脚本、npm/pnpm、源码编译所有Windows安装方式，带你从后台服务到边角残留，一步步实现真正的零残留彻底卸载。

前置必读

适用范围

  • 操作系统：Windows 10 20H2+ / Windows 11 全版本
  • 适配安装方式：官方一键脚本安装、npm/pnpm全局安装、国内镜像版安装、源码编译安装
  • 核心目标：彻底清理所有组件，无后台残留、无开机自启、无配置遗留、不影响后续重装

核心前提

所有命令必须以「管理员身份」运行 PowerShell/Windows 终端，否则会出现权限不足、卸载失败、文件无法删除等问题。

操作方式：右键点击Windows开始菜单，选择「Windows PowerShell (管理员)」（Windows 11选择「终端(管理员)」），在弹出的UAC权限提示中点击「是」。

重要备份提示

卸载操作会不可逆地删除所有本地配置、API密钥、对话记忆、自定义技能、任务日志。如需保留相关数据，请先备份以下目录，再执行卸载操作：

%USERPROFILE%\.openclaw

方案一：官方一键卸载（新手首选，90%用户适用）

这是OpenClaw官方内置的卸载方案，全程1-3条命令，自动清理网关服务、计划任务、配置数据、工作区文件，操作最简单，不会出现漏删问题，也是官方优先推荐的卸载方式。

步骤1：执行官方全量卸载命令

在管理员终端中，粘贴以下命令并回车执行：

openclaw uninstall --all --yes --non-interactive
  • 命令参数说明：
    • --all：清理所有相关组件，包括网关服务、系统计划任务、配置文件、工作区数据
    • --yes --non-interactive：非交互静默模式，自动确认所有卸载提示，无需手动二次确认
  • 执行完成标志：终端输出以下内容，说明核心组件已全部清理完成 
    ✓ Gateway service removed
✓ State + config deleted
✓ Workspace cleaned
OpenClaw has been uninstalled.

步骤2：清理全局CLI命令行工具

上一步仅清理了服务和数据，需执行这条命令，彻底删除终端的openclaw命令本体，覆盖官方版与国内镜像版：

# 官方版卸载
npm uninstall -g openclaw
# 国内镜像版卸载
npm uninstall -g openclaw-cn

# 若你使用pnpm安装，额外执行以下命令
pnpm uninstall -g openclaw
pnpm uninstall -g openclaw-cn

备用方案（CLI命令失效专用）

若终端提示「‘openclaw’ 不是内部或外部命令」，说明CLI工具已损坏，无法直接调用卸载命令，执行这条命令临时调用并完成全量卸载：

npx -y openclaw uninstall --all --yes --non-interactive

方案二：手动分步彻底卸载（兜底方案，100%无残留）

如果一键卸载失败、服务仍有残留、重装后旧配置依然生效，用这套分步方案，严格按照顺序执行，可100%清理所有相关文件和服务，适配所有安装场景，也是解决卸载不干净的终极方案。

步骤1：停止并彻底清除后台网关服务&开机自启（最优先）

OpenClaw的后台运行与开机自启，是通过Windows计划任务实现的，不先清理会导致文件占用、后台残留、卸载后依然开机自启。

  1. 先停止正在运行的网关服务：
openclaw gateway stop
  1. 卸载系统计划任务，彻底关闭开机自启：
openclaw gateway uninstall
  1. 若命令失效，强制删除Windows计划任务（兜底方案，官方推荐）：
# 强制删除默认计划任务
schtasks /Delete /F /TN "OpenClaw Gateway"
# 兼容自定义配置的计划任务
schtasks /Delete /F /TN "OpenClaw Gateway (default)" 2>$null
# 删除网关服务启动脚本
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd" -ErrorAction SilentlyContinue

步骤2：卸载全局OpenClaw主程序（全安装方式覆盖）

根据你的安装方式，执行对应卸载命令，彻底删除全局安装的CLI命令行工具：

# 1. 官方一键脚本/npm 安装的卸载
npm uninstall -g openclaw 2>$null
npm uninstall -g openclaw-cn 2>$null

# 2. pnpm 全局安装的卸载
pnpm uninstall -g openclaw 2>$null
pnpm uninstall -g openclaw-cn 2>$null

# 3. 源码编译本地安装的卸载
# 先进入你当初克隆的openclaw源码目录，再执行这条命令
# 示例：cd C:\Users\你的用户名\openclaw-cn
pnpm uninstall -g . 2>$null

步骤3：删除核心配置&数据目录（90%残留的根源）

这一步是彻底卸载的核心，OpenClaw所有的配置、API密钥、对话记忆、技能插件、日志都存在这个目录里，只卸载程序不删这个目录，重装后旧配置会直接复用，甚至导致报错。

方式1：命令一键删除（推荐，无遗漏）
# 删除主配置目录
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw" -ErrorAction SilentlyContinue
# 删除自定义配置目录（若有）
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw-default" -ErrorAction SilentlyContinue
方式2：手动删除（新手可视化操作）
  1. 按下 Win + R 打开运行窗口，粘贴以下路径并回车：
%USERPROFILE%
  1. 在打开的文件夹中，找到 .openclaw 文件夹，右键直接删除即可。

注：该文件夹为隐藏文件夹，若找不到，可在文件资源管理器顶部「查看」选项中，勾选「隐藏的项目」。

步骤4：清理包管理器缓存&依赖残留

清理npm/pnpm/corepack的缓存文件，避免残留安装包、依赖文件导致后续重装报错，同时释放磁盘空间：

# 清理npm全局缓存
npm cache clean --force 2>$null
# 清理pnpm全局缓存
pnpm cache clean --force 2>$null
# 清理corepack pnpm缓存（自动安装时生成）
corepack clean pnpm 2>$null
# 清理npm全局目录残留文件
Remove-Item -Recurse -Force "$env:APPDATA\npm\node_modules\openclaw" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:APPDATA\npm\node_modules\openclaw-cn" -ErrorAction SilentlyContinue

步骤5：进阶深度清理（极致无残留，可选）

如果想要极致干净，额外执行这几步，清理所有边角残留，适配源码编译安装、多Node.js版本管理的场景：

  1. 终止所有残留进程：
Get-Process | Where-Object { $_.Name -like "*openclaw*" } | Stop-Process -Force -ErrorAction SilentlyContinue
Get-Process | Where-Object { $_.MainModule.FileName -like "*openclaw*" } | Stop-Process -Force -ErrorAction SilentlyContinue
  1. 释放端口占用：
# 清理OpenClaw默认端口18789的占用进程
$portProcess = netstat -ano | findstr :18789
if ($portProcess) { $pid = $portProcess.Split(' ')[-1]; Stop-Process -Id $pid -Force -ErrorAction SilentlyContinue }
  1. 删除源码目录与本地脚本残留：
# 删除你克隆的源码文件夹（示例路径，替换为你的实际路径）
Remove-Item -Recurse -Force "C:\Users\你的用户名\openclaw-cn" -ErrorAction SilentlyContinue
# 删除本地bin目录残留脚本
Remove-Item -Force "$env:USERPROFILE\.local\bin\openclaw.cmd" -ErrorAction SilentlyContinue
Remove-Item -Force "$env:USERPROFILE\.local\bin\openclaw.ps1" -ErrorAction SilentlyContinue

必做：卸载完成验证（4步确认彻底干净）

执行完以上步骤后，关闭所有终端窗口，重新打开一个普通PowerShell窗口，依次执行以下命令，确认无任何残留：

  1. 命令残留验证
openclaw --version

✅ 成功标志：终端提示「‘openclaw’ 不是内部或外部命令，也不是可运行的程序或批处理文件」

  1. 进程残留验证
tasklist | findstr openclaw

✅ 成功标志：无任何输出，说明无后台运行的OpenClaw相关进程

  1. 服务与端口验证
netstat -ano | findstr 18789

✅ 成功标志：无任何输出，说明默认端口已释放，无网关服务残留

  1. 文件目录验证
    打开 %USERPROFILE% 路径，确认 .openclaw 文件夹已不存在，无相关安装目录残留。

懒人专属：全量一键卸载脚本（复制即用）

不想一步步手动操作，直接复制下面的完整脚本，粘贴到管理员PowerShell中，回车即可自动完成全量卸载，全程无需手动干预：

# ==============================================
# OpenClaw Windows 全量一键卸载脚本
# 适用：所有安装方式，彻底清理无残留
# 必须：以管理员身份运行PowerShell执行
# ==============================================

Write-Host ">>> 开始卸载OpenClaw，正在停止网关服务..." -ForegroundColor Yellow
# 1. 停止网关服务，卸载计划任务
openclaw gateway stop 2>$null
openclaw gateway uninstall 2>$null

Write-Host ">>> 正在删除开机自启计划任务..." -ForegroundColor Yellow
# 2. 强制删除Windows计划任务（兜底）
schtasks /Delete /F /TN "OpenClaw Gateway" 2>$null
schtasks /Delete /F /TN "OpenClaw Gateway (default)" 2>$null
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd" -ErrorAction SilentlyContinue

Write-Host ">>> 正在卸载全局CLI程序..." -ForegroundColor Yellow
# 3. 卸载全局主程序
npm uninstall -g openclaw 2>$null
npm uninstall -g openclaw-cn 2>$null
pnpm uninstall -g openclaw 2>$null
pnpm uninstall -g openclaw-cn 2>$null

Write-Host ">>> 正在删除核心配置与数据目录..." -ForegroundColor Yellow
# 4. 彻底删除配置与数据目录
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw-default" -ErrorAction SilentlyContinue

Write-Host ">>> 正在清理包管理器缓存与残留..." -ForegroundColor Yellow
# 5. 清理缓存与全局残留
npm cache clean --force 2>$null
pnpm cache clean --force 2>$null
corepack clean pnpm 2>$null
Remove-Item -Recurse -Force "$env:APPDATA\npm\node_modules\openclaw" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:APPDATA\npm\node_modules\openclaw-cn" -ErrorAction SilentlyContinue
Remove-Item -Force "$env:USERPROFILE\.local\bin\openclaw*" -ErrorAction SilentlyContinue

Write-Host ">>> 正在终止残留进程..." -ForegroundColor Yellow
# 6. 终止所有相关进程
Get-Process | Where-Object { $_.Name -like "*openclaw*" } | Stop-Process -Force -ErrorAction SilentlyContinue

Write-Host "✅ OpenClaw 已彻底卸载清理完成！" -ForegroundColor Green
Write-Host "👉 请关闭所有终端，重新打开即可验证卸载结果" -ForegroundColor Gray

高频问题 FAQ（踩坑必看）

Q1：卸载了命令还能用，怎么办？

A：大概率是使用了nvm等工具管理多版本Node.js，导致CLI程序安装在了其他Node.js版本的目录中。执行 where.exe openclaw 查看命令所在路径，直接删除对应的 openclaw.cmd、openclaw.ps1 文件，再切换到对应Node.js版本重新执行卸载命令即可。

Q2：删除文件夹提示「文件正在占用/无法删除」，怎么办？

A：先执行 openclaw gateway stop 停止服务，再执行任务管理器终止所有node、openclaw相关进程，关闭所有终端窗口，重新以管理员身份打开终端执行删除命令；若仍报错，重启电脑后再执行删除操作即可。

Q3：国内镜像版（openclaw-cn）卸载有区别吗？

A：没有本质区别，本文所有命令均适配国内镜像版，只需在卸载全局程序时，额外执行 npm uninstall -g openclaw-cn 即可，计划任务、配置目录的清理方式完全一致。

Q4：想重装OpenClaw，卸载完直接装吗？

A：是的，确认卸载干净后，直接用国内镜像一键脚本安装即可，不会有旧配置残留：

iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex

Q5：卸载后，之前配置的API密钥还安全吗？

A：彻底删除 .openclaw 目录后，本地存储的密钥会被完全清除。为了极致安全，建议前往对应大模型平台，废弃旧的API Key，重新生成新的密钥，同时撤销OpenClaw在飞书、微信、钉钉等平台的第三方应用授权。

写在最后

Windows系统上卸载OpenClaw不干净的核心原因，无非是漏删了计划任务、没清理配置目录、没卸载全局CLI程序这三点。无论是新手用官方一键卸载，还是用兜底的手动分步方案，只要覆盖这三个核心点，就能彻底和“大龙虾”说再见，无任何残留，也不会影响后续的重装使用。

# windows # c# # python # java # 人工智能
Logo
龙虾开发者社区

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用

更多推荐

cover

Agent 网关限频实战：如何用令牌桶平衡 CFO 成本与用户体验

avatar 龙虾开发者社区
cover

ClawOS 容器化实战：rootless Podman 如何平衡 Agent 便利与安全逃逸风险？

avatar 龙虾开发者社区
cover

ClawBridge 跨云 MCP 调试噩梦：mTLS 双向校验为何让故障排查时间翻倍？

avatar 龙虾开发者社区