详细步骤 + 截图，一目了然

前言

OpenClaw（俗称“小龙虾”）是一款运行在本地的开源 AI 智能体，通过 npm 全局包安装，会在系统中注册守护进程和工作区配置目录。仅执行 npm uninstall -g openclaw 无法完全卸载，必须额外清理守护进程、配置目录和缓存文件，才能实现彻底移除。

本文提供 Windows / macOS / Linux 全平台卸载指南，配合截图，手把手教你卸载干净。

一、卸载前准备

1.1 备份重要数据（如需要）

如果你想保留配置和对话记录，建议先备份：

Windows: C:\Users\你的用户名\.openclaw\
macOS/Linux: ~/.openclaw/

1.2 停止相关服务

在卸载前，建议先停止 OpenClaw 的网关服务：

bash
openclaw gateway stop
openclaw daemon stop

二、Windows 系统卸载

第一步：打开终端

按 Win + R，输入 cmd 或搜索 PowerShell，右键选择 以管理员身份运行。

第二步：执行官方卸载命令

这是最推荐的卸载方式，直接使用 OpenClaw 内置的卸载器：

bash
openclaw uninstall --all --yes

参数说明：

• --all：彻底删除，包括网关服务、本地数据库、配置文件等所有数据
• --yes：全程自动确认，无需手动按 Y 确认

第三步：删除命令行工具

如果想彻底清除 CLI 工具，继续执行：

bash
npm uninstall -g openclaw

第四步：手动清理残留（如需要）

如果官方命令无法使用，可以手动清理：

4.1 删除配置目录

bash
rm -r C:\Users\你的用户名\.openclaw

或使用 PowerShell：

powershell
Remove-Item-Recurse -Force C:\Users\你的用户名\.openclaw

4.2 删除 npm 全局包

bash
npm uninstall -g openclaw

4.3 检查并删除计划任务（如有）

打开 任务计划程序，查找 OpenClaw 相关任务并删除。

三、macOS / Linux 系统卸载

第一步：打开终端

• macOS：按 Command + Space，搜索“终端”或"Terminal"
• Linux：按 Ctrl + Alt + T 或从应用菜单打开终端

第二步：执行官方卸载命令

bash
openclaw uninstall --all --yes

第三步：删除命令行工具

bash
# npm 安装npm uninstall -g openclaw
# pnpm 安装pnpm remove -g openclaw
# bun 安装bun remove -g openclaw

第四步：手动清理残留（如需要）

4.1 删除配置目录

bash
rm -rf ~/.openclaw

4.2 删除服务文件（macOS）

bash
# 停止守护进程openclaw daemon stop
# 卸载守护进程sudo openclaw daemon uninstall
# 删除 plist 文件（如有）rm ~/Library/LaunchAgents/ai.openclaw.*

4.3 删除服务文件（Linux）

bash
# 停止守护进程sudo openclaw daemon stop
# 卸载守护进程sudo openclaw daemon uninstall
# 删除 systemd 服务文件（如有）sudorm /etc/systemd/system/openclaw-*.service

四、验证是否卸载干净

检查 CLI 是否已删除

bash
# Windowswhere openclaw
# macOS/Linuxwhich openclaw

如果返回“找不到命令”，说明 CLI 已成功删除。

检查服务是否已停止

bash
# Windows PowerShellGet-Service *openclaw* -ErrorAction SilentlyContinue
# macOSlaunchctl list |grep openclaw
# Linuxsystemctl status openclaw*

检查配置目录是否已删除

bash
# Windowsdir C:\Users\你的用户名\.openclaw
# macOS/Linuxls ~/.openclaw

如果返回“找不到文件或目录”，说明配置已清理干净。

五、注意事项

⚠️ 重要提醒

1.重启电脑：卸载完成后，建议重启一次电脑，确保所有后台进程彻底关闭。
2.更换 API Key：如果你曾在 OpenClaw 中绑定过 API Key（如 OpenAI、Claude 等），强烈建议去对应官网废弃旧密钥，生成新密钥，以防万一。
3.谨慎操作：删除配置目录会清除所有配置和对话记录，如有需要请提前备份。

六、常见问题

Q1：执行 openclaw uninstall 提示找不到命令？

说明 CLI 已被删除但服务还在，请直接跳转到对应系统的“手动清理”步骤。

Q2：遇到权限错误？

在命令前添加 sudo（macOS/Linux）或“以管理员身份运行”（Windows）。

Q3：重装后发现还在读取旧配置？

说明配置目录没有清理干净，请手动删除 ~/.openclaw 或 C:\Users\用户名\.openclaw。

结语

按照以上步骤操作，即可将 OpenClaw 卸载得干干净净。如果在卸载过程中遇到任何问题，欢迎在评论区留言交流。

祝你卸载顺利！