彻底卸除OpenClaw需五步并行：一、执行openclaw uninstall --all --yes或npx调用；二、按npm/pnpm/bun/源码方式卸载CLI；三、停止并卸载网关与守护进程；四、删除~/.openclaw等配置目录；五、清理包管理器全局缓存及残留模块。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试从系统中移除 openclaw（龙虾），但发现命令仍可调用、服务仍在后台运行或配置文件残留，则说明卸载未彻底。openclaw 的架构包含命令行工具、网关服务、守护进程、用户配置目录及系统自启项，仅删除主程序无法清除全部组件。以下是多种并行有效的彻底移除方法：一、执行官方内置卸载命令
该方法由 OpenClaw 自身提供，可自动停止网关服务、删除工作区、配置文件及本地数据库，覆盖 Windows、macOS 和 Linux 平台，是优先推荐的起点。
1、打开终端（Windows 使用 PowerShell 或 CMD；macOS/Linux 使用 Terminal）。
2、输入以下命令并回车执行：openclaw uninstall --all --yes。
3、若提示“command not found”，说明 CLI 已不可见，改用临时调用方式：npx -y openclaw uninstall --all --yes。
4、等待输出 “Uninstallation completed” 或类似成功提示后，核心组件已清除。
二、按安装方式卸载 CLI 工具
官方卸载命令通常不移除全局安装的命令行可执行文件本身，需根据原始安装方式单独清理，避免终端仍能识别 openclaw 命令。
1、若通过 npm 全局安装：npm uninstall -g openclaw。
2、若通过 pnpm 全局安装：pnpm remove -g openclaw。
3、若通过 bun 全局安装：bun remove -g openclaw。
4、若为源码编译安装：查找并删除可执行文件，常见路径包括 /usr/local/bin/openclaw（macOS/Linux）或 C:\Users\用户名\AppData\Roaming\npm\openclaw 及 openclaw.cmd（Windows）。
三、手动停止并卸载后台服务
OpenClaw 可能注册为系统级守护进程或网关服务，即使 CLI 卸载完成，其仍可能在后台持续运行并占用端口或调用 API，必须显式终止并解除注册。
1、停止网关服务：openclaw gateway stop。
2、停止守护进程（如启用）：openclaw daemon stop。
3、卸载守护进程注册项：macOS 用户执行 sudo openclaw daemon uninstall 并删除 ~/Library/LaunchAgents/ai.openclaw.*；Linux 用户执行 sudo openclaw daemon uninstall 并删除 /etc/systemd/system/openclaw-*.service；Windows 用户需在“任务计划程序”中搜索并禁用 OpenClaw 相关任务。
四、删除用户配置与数据目录
配置目录存储 API 密钥、会话记录、soul.md 文件及工作区数据，若未主动清理，存在隐私泄露与资源占用风险，必须手动移除。
1、Windows 系统执行 PowerShell 命令：Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw。
2、macOS 系统执行：rm -rf ~/.openclaw 和 rm -rf ~/.config/openclaw。
3、Linux 系统执行：rm -rf ~/.openclaw。
4、如需保留数据，卸载前应先备份该目录，但备份后须确保副本不被误用或泄露。
五、清理 npm/pnpm/bun 全局缓存与模块残留
包管理器可能在全局 node_modules 中残留未被引用的 OpenClaw 模块或依赖，尤其在多次安装/卸载后易形成冗余，影响后续工具链稳定性。
1、清空 npm 全局缓存：npm cache clean --force，再执行 npm ls -g --depth=0 | findstr openclaw（Windows）或 npm ls -g --depth=0 | grep openclaw（macOS/Linux）确认无残留。
2、删除 npm 全局模块中的孤立目录：rm -r $HOME\AppData\Roaming\npm\node_modules\openclaw（Windows）或 rm -r /usr/local/lib/node_modules/openclaw（macOS/Linux）。
3、对 pnpm 用户，执行：pnpm store prune 并检查 pnpm list -g | grep openclaw。
4、对 bun 用户，执行：bun pm prune 并验证 bun list -g | grep openclaw 返回为空。
