夜雨聆风教程说明：本教程为步骤标注式可视化指引，用文字框、箭头、数字标注清晰标出每一步操作位置、输入内容、点击按钮，全程跟着标注操作即可；覆盖Windows、macOS两大主流系统，Linux附精简标注版，含进程关闭、官方卸载、服务卸载、全残留文件清理、最终验证，彻底无死角。 |
第一部分：卸载前通用准备（所有系统必做，带标注）
步骤1：强制关闭所有OpenClaw相关进程（防文件占用）
核心目的：避免进程占用文件，导致卸载失败、残留无法删除
Windows系统 进程关闭
操作路径标注：
1. 键盘同时按 Ctrl + Shift + Esc→ 弹出【任务管理器】窗口
2. 任务管理器界面标注：
┌─────────────────────────────────────────────────────┐ │ 任务管理器 │ 进程(P) │ 性能 │ 应用历史 │ 启动 │ │ ├─────────────────────────────────────────────────────┤ │ �� 搜索框【此处输入：openclaw】↓ │ │ │ │ 找到进程：openclaw.exe / node.exe / Clawdbot │ │ ↖️ 箭头指向该进程 │ │ 右键点击 → 弹出菜单【结束任务(E)】✅ 点击此处 │ │ │ │ 重复操作：搜索node.exe，同样右键【结束任务】 │ └─────────────────────────────────────────────────────┘ |
标注重点：必须结束openclaw、node、Clawdbot三个核心进程，缺一不可
macOS系统 进程关闭
操作路径标注：
1. 打开【启动台】→ 【其他】文件夹 → 点击【活动监视器】
2. 活动监视器界面标注：
┌─────────────────────────────────────────────────────┐ │ 活动监视器 │ CPU │ 内存 │ 磁盘 │ 网络 │ ├─────────────────────────────────────────────────────┤ │ �� 右上角搜索框【输入：openclaw】↓ │ │ │ │ 选中搜索结果：openclaw / node / moltbot │ │ ↖️ 箭头指向进程名 │ │ 点击左上角 ❌ 图标 → 弹出选项【强制退出】✅ 点击此处 │ │ │ │ 重复操作：搜索node，同样强制退出 │ └─────────────────────────────────────────────────────┘ |
步骤2：检查端口占用（确认无后台服务运行）
OpenClaw默认占用18789端口，检查无占用再继续卸载
Windows标注：管理员PowerShell输入 netstat -ano | findstr :18789→ 无任何输出即为正常
macOS标注：终端输入 lsof -i :18789→ 无任何输出即为正常
第二部分：Windows系统 完整卸载流程（带全步骤标注）
关键前提：必须以管理员身份打开PowerShell，普通权限会卸载失败 |
步骤1：以管理员身份打开PowerShell
┌─────────────────────────────────────────────────────┐ │ 1. 键盘按 Win + X → 弹出快速菜单 │ │ 2. 菜单选项：【Windows PowerShell(管理员)】✅ 点击此处 │ │ 3. 弹出用户账户控制 → 点击【是(Y)】确认权限 │ │ 4. 打开窗口标题栏显示：管理员: Windows PowerShell │ └─────────────────────────────────────────────────────┘ |
步骤2：官方命令卸载（核心步骤，命令行标注）
PowerShell窗口内，按顺序输入以下命令，每输完一行按回车执行
┌─────────────────────────────────────────────────────┐ │ 管理员PowerShell窗口 │ │ │ │ 命令1（停止网关服务）： │ │ openclaw gateway stop→ 此处输入，回车执行 │ │ │ │ 命令2（卸载网关服务）： │ │ openclaw gateway uninstall→ 输入，回车执行 │ │ │ │ 命令3（全量彻底卸载）： │ │ openclaw uninstall --all --yes --non-interactive│ │ → 输入完整命令，回车执行（自动确认，无交互） │ │ │ │ ✅ 执行成功提示：无报错，显示卸载完成相关字样 │ │ ❌ 命令不存在：替换执行 npx -y openclaw uninstall --all │ └─────────────────────────────────────────────────────┘ |
步骤3：删除开机自启计划任务
继续在管理员PowerShell输入命令，彻底禁用自启
┌─────────────────────────────────────────────────────┐ │ 输入命令：schtasks /Delete /F /TN "OpenClaw Gateway"│ │ 回车执行 → 提示【成功】即为删除完成 │ │ 标注：/F 代表强制删除，避免弹窗确认，一键完成 │ └─────────────────────────────────────────────────────┘ |
步骤4：卸载全局CLI工具（npm/pnpm版）
针对npm安装的OpenClaw，清理全局命令残留
┌─────────────────────────────────────────────────────┐ │ 命令1（npm卸载）：npm uninstall -g openclaw回车│ │ 命令2（清理npm缓存）：npm cache clean --force回车│ │ 标注：-g 代表全局卸载，清除系统Path里的openclaw命令 │ └─────────────────────────────────────────────────────┘ |
第三部分：Windows 彻底残留文件清理（全覆盖，路径标注）
核心标注：以下所有路径直接复制到PowerShell执行，自动删除所有隐藏残留、配置、缓存、日志、注册表残留，无手动找文件夹麻烦 |
步骤1：删除用户目录所有残留文件夹（命令行标注）
┌─────────────────────────────────────────────────────────────────┐ │ 逐条复制以下命令，回车执行，无报错即为删除成功 │ │ │ │ 1. 核心配置文件夹（必删）：Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw" │ │ 2. 应用数据残留：Remove-Item -Recurse -Force "$env:APPDATA\openclaw" │ │ 3. 本地缓存残留：Remove-Item -Recurse -Force "$env:LOCALAPPDATA\openclaw" │ │ 4. 旧版源码文件夹：Remove-Item -Recurse -Force "$env:USERPROFILE\openclaw" │ │ 5. 桌面快捷方式：Remove-Item -Force "$env:USERPROFILE\Desktop\OpenClaw.lnk" │ └─────────────────────────────────────────────────────────────────┘ |
步骤2：清理注册表残留（谨慎操作）
┌─────────────────────────────────────────────────────┐ │ 1. 键盘按 Win + R → 弹出运行窗口 │ │ 2. 运行框输入：regedit→ 点击【确定】✅ │ │ 3. 注册表编辑器左侧路径栏： │ │ → 展开 HKEY_CURRENT_USER\Software │ │ → 找到 OpenClaw文件夹→ 右键【删除】 │ │ → 展开 HKEY_LOCAL_MACHINE\Software │ │ → 找到 OpenClaw文件夹→ 右键【删除】 │ │ 标注：无对应文件夹则跳过，无需强行查找 │ └─────────────────────────────────────────────────────┘ |
步骤3：清理环境变量残留
┌─────────────────────────────────────────────────────┐ │ 1. 右键【此电脑】→ 点击【属性】 │ │ 2. 右侧点击【高级系统设置】→ 弹出窗口 │ │ 3. 点击底部【环境变量(N)】✅ 点击此处 │ │ 4. 分别查看【用户变量】和【系统变量】的Path路径 │ │ 5. 找到含 openclaw的路径→ 选中【删除】→ 确定 │ └─────────────────────────────────────────────────────┘ |
第四部分：macOS系统 完整卸载流程（带步骤）
步骤1：打开终端
┌─────────────────────────────────────────────────────┐ │ 1. 启动台 → 其他文件夹 → 【终端】图标 ✅ 点击打开 │ │ 2. 终端窗口标题显示：zsh/bash 终端 │ └─────────────────────────────────────────────────────┘ |
步骤2：官方命令卸载
┌─────────────────────────────────────────────────────┐ │ 终端内逐条输入，回车执行 │ │ 1. 停止服务：openclaw gateway stop 回车 │ │ 2. 卸载服务：openclaw gateway uninstall 回车 │ │ 3. 全量卸载：openclaw uninstall --all --yes 回车 │ │ ✅ 成功：无报错，终端回到输入状态 │ │ ❌ 命令不存在：执行 npx -y openclaw uninstall --all │ └─────────────────────────────────────────────────────┘ |
步骤3：删除开机自启服务
┌─────────────────────────────────────────────────────┐ │ 输入命令：rm -f ~/Library/LaunchAgents/com.openclaw.*.plist │ │ 回车执行 → 无输出即为成功 │ └─────────────────────────────────────────────────────┘ |
第五部分：macOS 彻底残留文件清理
┌─────────────────────────────────────────────────────────────────┐ │ 终端内复制以下所有命令，一次性执行，删除所有隐藏残留 │ │ │ │ 1. 核心配置：rm -rf ~/.openclaw │ │ 2. 多配置文件：rm -rf ~/.openclaw-* │ │ 3. 应用支持：rm -rf ~/Library/Application\ Support/OpenClaw │ │ 4. 缓存日志：rm -rf ~/Library/Caches/OpenClaw ~/Library/Logs/OpenClaw │ │ 5. 偏好设置：rm -f ~/Library/Preferences/com.openclaw.*.plist │ │ 6. CLI命令：rm -f /usr/local/bin/openclaw /opt/homebrew/bin/openclaw │ │ 7. 桌面APP：rm -rf /Applications/OpenClaw.app │ │ 标注：rm -rf 为强制删除，无确认提示，执行即清理完成 │ └─────────────────────────────────────────────────────────────────┘ |
第六部分：Linux系统（Ubuntu/Debian）卸载
1. 终端执行：pkill -f openclaw && pkill -f node
2. 卸载服务：systemctl --user stop openclaw-gateway && systemctl --user disable openclaw-gateway
3. 全量卸载：openclaw uninstall --all --yes
4. 残留清理：rm -rf ~/.openclaw ~/.config/openclaw ~/.cache/openclaw /usr/local/bin/openclaw
第七部分：最终验证确认彻底卸载
验证标准：以下两步完全无输出、无结果，才代表彻底无残留
Windows验证
┌─────────────────────────────────────────────────────┐ │ 管理员PowerShell输入：Get-Command openclaw │ │ ✅ 彻底卸载结果：无任何输出、无报错│ │ 输入：netstat -ano | findstr :18789 │ │ ✅ 结果：无任何端口占用信息 │ └─────────────────────────────────────────────────────┘ |
macOS验证
┌─────────────────────────────────────────────────────┐ │ 终端输入：which openclaw │ │ ✅ 彻底卸载结果：无任何输出│ │ 输入：lsof -i :18789 │ │ ✅ 结果：无端口占用信息 │ └─────────────────────────────────────────────────────┘ |
第八部分：常见问题排查（标注解决办法）
•问题1：权限不足，无法删除文件→ 标注解决：Windows重新开管理员PowerShell；macOS命令前加sudo
•问题2：进程无法结束→ 标注解决：直接重启电脑，重启后跳过进程步骤，直接卸载
•问题3：命令仍存在→ 标注解决：重新执行CLI卸载命令，手动删除Path里的openclaw路径
•问题4：残留文件夹删不掉→ 标注解决：重启电脑后，再执行残留清理命令
最终收尾：完成所有步骤后，重启电脑，OpenClaw相关进程、服务、命令、配置文件、缓存、注册表、环境变量全部彻底清除，系统无任何残留，卸载完成！ |
