在开始卸载之前,建议先做几件事情,确保卸载后不留残余文件。
卸载前的准备工作
停止正在运行的 OpenClaw 守护进程(daemon)
如果你使用了 Gateway 服务,先手动停止它,否则可能有残留进程占用端口或文件。
# 停止守护进程
openclaw daemon stop
# 或者停止 Gateway 服务
openclaw gateway stop
备份配置文件(可选)
如果你不确定是否需要保留已有配置,建议先备份:
- macOS / Linux:
~/.openclaw/ - Windows:
%USERPROFILE%\.openclaw\
⚠️ 注意: 卸载 OpenClaw 本体不会自动删除你的配置目录(
~/.openclaw/),如需彻底清除,需要手动删除该目录。
Windows — PowerShell 安装的卸载方法
PowerShell 脚本通过 npm install -g openclaw 全局安装 OpenClaw,并将其写入 Windows 的用户 PATH(通常是 %APPDATA%\npm)。
执行 npm 卸载命令
以管理员身份打开 PowerShell,执行以下命令移除全局包:
npm uninstall -g openclaw
验证卸载结果
Get-Command openclaw -ErrorAction SilentlyContinue
如果没有任何输出,说明已卸载成功。
彻底清除残留文件
# 删除配置目录
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
# 如果有遗留的 git 安装(~/openclaw 目录),一并删除
Remove-Item -Recurse -Force "$env:USERPROFILE\openclaw"
# 删除 .local\bin 中的包装脚本(git 方式安装时创建)
Remove-Item -Force "$env:USERPROFILE\.local\bin\openclaw.cmd" -ErrorAction SilentlyContinue
💡 如果 PowerShell 安装时使用了
-InstallMethod git参数,还需额外删除$env:USERPROFILE\openclaw(git 克隆目录)和$env:USERPROFILE\.local\bin\openclaw.cmd(包装脚本)。
Windows — CMD 安装的卸载方法
CMD 脚本的底层安装机制与 PowerShell 脚本相同,最终都是通过 npm install -g openclaw 完成安装,因此卸载方式一致。
执行卸载命令
打开命令提示符(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"


