OpenClaw 卸载完全指南
本文涵盖 Windows、macOS、Linux 以及 npm、pnpm 等主流安装方式的完整卸载流程,确保不留残余文件。
卸载前的准备
在动手之前,建议先做两件事,避免后续出现端口占用或配置残留。
1. 停止守护进程
如果正在运行 Gateway 服务或 daemon,请先手动停止。否则卸载后可能有残留进程占用资源。
# PowerShell / CMD
openclaw daemon stop
# 或者停止 Gateway 服务
openclaw gateway stop
2. 备份配置文件(可选)
如果你不确定是否需要保留现有配置,建议先备份目录。
- macOS / Linux:
~/.openclaw/ - Windows:
%USERPROFILE%\.openclaw\
⚠️ 注意:卸载 OpenClaw 本体不会自动删除配置目录。如需彻底清除,需手动删除该目录。
Windows 系统卸载
PowerShell 和 CMD 脚本的底层安装机制相同,均通过 npm install -g openclaw 全局安装并写入 PATH。因此卸载核心命令一致,区别仅在于残留文件的清理语法。
PowerShell 方式
以管理员身份打开 PowerShell,执行以下操作:
-
移除全局包
npm uninstall -g openclaw -
验证卸载结果
Get-Command openclaw -ErrorAction SilentlyContinue # 若无输出,说明已卸载成功 -
清理残留文件 如果使用了
-InstallMethod 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),逻辑与 PowerShell 类似:
-
移除全局包
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"


