若OpenClaw卸载后仍有残留，需按五步彻底清理：一、全局npm包卸载；二、删除用户配置目录；三、清除自启动服务；四、清理命令行脚本与环境变量；五、终止残留进程及端口占用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已执行基础卸载操作，但 OpenClaw 仍残留配置目录、服务项或命令行入口，则说明卸载未彻底。以下是针对各平台残留项的精准清理步骤：
一、验证并清除全局 npm 包残留
npm 全局安装的 openclaw 可能未被完全移除，导致命令仍可调用或新安装冲突。需确认并强制卸载。
1、以管理员身份打开 PowerShell（Windows）或终端（macOS/Linux）。
2、执行卸载命令：npm uninstall -g openclaw。
3、验证是否清除成功：运行 Get-Command openclaw -ErrorAction SilentlyContinue（PowerShell）或 which openclaw（macOS/Linux），若无任何输出即为成功。
二、删除用户级配置与数据目录
OpenClaw 默认将配置、日志及工作文件存于用户主目录下隐藏路径，这些不会随主程序卸载而自动清除，必须手动定位并删除。
1、Windows 用户执行以下三条命令（逐条粘贴运行）：
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:USERPROFILE\openclaw" -ErrorAction SilentlyContinue
Remove-Item -Force "$env:USERPROFILE\.local\bin\openclaw.cmd" -ErrorAction SilentlyContinue
2、macOS 用户执行：
rm -rf ~/Library/Application\ Support/OpenClaw
rm -rf ~/.openclaw
rm -f ~/Library/LaunchAgents/ai.openclaw.*
3、Linux 用户执行：
rm -rf ~/.openclaw
rm -rf ~/openclaw
rm -f ~/.config/systemd/user/openclaw-gateway.service
三、终止并清除自启动服务项
OpenClaw 常通过系统级服务机制实现开机自启，即使主程序删除，服务仍可能驻留后台或注册表中，需针对性清除。
1、Windows 系统清理计划任务：
schtasks /Delete /F /TN "OpenClaw Gateway"
schtasks /Delete /F /TN "OpenClaw Proxy"
2、macOS 系统停用 launchd 服务：
launchctl bootout gui/$UID/ai.openclaw.gateway
launchctl bootout gui/$UID/ai.openclaw.proxy
3、Linux 系统禁用 systemd 用户服务：
systemctl --user stop openclaw-gateway.service openclaw-proxy.service
systemctl --user disable openclaw-gateway.service openclaw-proxy.service
systemctl --user daemon-reload
四、清理命令行包装脚本与环境变量污染
部分安装方式（如 git + pnpm 或自定义脚本）会在 PATH 中写入临时包装脚本，造成命令残留或误触发。
1、Windows 检查并删除 npm bin 路径下的残留文件：
where openclaw —— 查看所有匹配路径
del /f "C:\Users\%USERNAME%\AppData\Roaming\npm\openclaw"
del /f "C:\Users\%USERNAME%\AppData\Roaming\npm\openclaw.cmd"
2、macOS/Linux 检查 shell 配置文件是否注入路径：
检查 ~/.zshrc、~/.bash_profile 或 ~/.profile 中是否含 export PATH="...:/some/path/to/openclaw/bin:$PATH" 类似行，若有则手动删除该行并执行 source ~/.zshrc 刷新。
五、扫描并清除进程与端口占用残留
即使命令与服务已删，OpenClaw 子进程或监听端口（如 3000、8080、9000）可能仍在运行，影响重装或引发冲突。
1、Windows 执行：
netstat -ano | findstr :3000 —— 查找占用 3000 端口的 PID
taskkill /F /PID [PID号] —— 强制结束对应进程
2、macOS/Linux 执行：
lsof -i :3000 —— 查看监听进程
kill -9 [PID号] —— 强制终止
3、统一检查常见 OpenClaw 相关进程名：
tasklist | findstr "openclaw"（Windows）
ps aux | grep -i openclaw（macOS/Linux）
killall -9 openclaw gateway proxy（macOS/Linux）
