OpenClaw 卸载完全指南
想要彻底卸载 OpenClaw,关键在于确认当初的安装方式。不同平台(Windows、macOS、Linux)和安装源(npm、pnpm、git)对应的清理步骤略有差异。下面按场景逐一说明。
卸载前的准备
无论采用哪种方式,建议先停止正在运行的服务,避免文件被占用导致删除失败。
停止守护进程
如果 Gateway 服务仍在运行,请先手动停止它:
openclaw daemon stop
# 或者停止 Gateway 服务
openclaw gateway stop
备份配置(可选)
如果你不确定是否需要保留现有配置,可以先备份配置文件目录:
- macOS / Linux:
~/.openclaw/ - Windows:
%USERPROFILE%\.openclaw\
注意:卸载 OpenClaw 本体通常不会自动删除配置目录,如需彻底清除,需手动处理。
Windows 环境卸载
PowerShell 和 CMD 脚本安装的底层机制基本一致,都是通过 npm install -g openclaw 全局安装到用户 PATH 中。
PowerShell 安装卸载
-
以管理员身份打开 PowerShell,执行 npm 卸载命令:
npm uninstall -g openclaw -
验证卸载结果:
Get-Command openclaw -ErrorAction SilentlyContinue如果没有输出,说明命令已移除。
-
清理残留文件:
为了不留死角,建议手动删除配置目录和可能的 git 克隆目录:
# 删除配置目录 Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw" # 如果有遗留的 git 安装目录 Remove-Item -Recurse -Force "$env:USERPROFILE\openclaw" # 删除 .local\bin 中的包装脚本 Remove-Item -Force "$env:USERPROFILE\.local\bin\openclaw.cmd" -ErrorAction SilentlyContinue
CMD 安装卸载
CMD 脚本同样依赖 npm 全局包,卸载逻辑相同,仅清理命令语法不同。
-
打开命令提示符(CMD),执行卸载命令:
npm uninstall -g openclaw -
验证卸载结果:
where openclaw若显示'无法找到文件',则卸载成功。
-
清理残留文件:
:: 删除配置目录 rmdir /s /q "%USERPROFILE%\.openclaw" :: 删除 git 源码目录(如果存在) rmdir /s /q "%USERPROFILE%\openclaw" :: 删除 .local\bin 包装脚本 del /f "%USERPROFILE%\.local\bin\openclaw.cmd"


