openclaw 是一款运行在本地的开源个人 AI 助手，支持 Mac / Windows / Linux 三平台，通过 npm 全局包安装，并在系统中注册守护进程（daemon）和工作区配置目录。仅执行 npm uninstall -g openclaw 无法完全卸载，必须额外清理守护进程、配置目录和缓存文件，才能实现彻底移除。

 

openclaw 在系统中留下了什么？

openclaw 安装后会在系统中写入 4 类数据：

类型

位置

说明

npm 全局包

$(npm root -g)/openclaw

主程序文件

工作区配置目录

~/.openclaw/

配置、凭证、Skills、对话记忆

守护进程服务

macOS: ~/Library/LaunchAgents/

Linux: ~/.config/systemd/user/

开机自启服务

npm 缓存

~/.npm/ 或 ~/.cache/npm/

安装缓存

只删除 npm 包，守护进程和 ~/.openclaw/ 目录会继续留在系统中，开机仍会自动启动相关进程。

 

彻底卸载步骤（推荐顺序）

彻底卸载分为 4 步，必须按顺序执行，跳过任何一步都可能留下残留。

第一步：停止并卸载守护进程

macOS（launchd）

 

# 查找 openclaw 服务名
launchctl list | grep openclaw
 
# 停止并卸载服务（将 com.openclaw.daemon 替换为实际服务名）
launchctl stop com.openclaw.daemon
launchctl unload ~/Library/LaunchAgents/com.openclaw.daemon.plist
 
# 删除 plist 文件
rm -f ~/Library/LaunchAgents/com.openclaw.*.plist

Linux（systemd）

 

# 停止并禁用服务
systemctl --user stop openclaw
systemctl --user disable openclaw
 
# 删除服务文件
rm -f ~/.config/systemd/user/openclaw*.service
systemctl --user daemon-reload

Windows（PowerShell）

 

# 查找 openclaw 相关进程
Get-Process | Where-Object { $_.Name -like "*openclaw*" }
 
# 停止进程
Stop-Process -Name "openclaw" -Force
 
# 从任务计划程序删除（如有）
schtasks /Delete /TN "openclaw" /F

第二步：卸载 npm 全局包

 

npm uninstall -g openclaw

验证是否已移除：

 

which openclaw   # 应无输出
openclaw --version  # 应报 command not found

 

第三步：删除配置目录和数据

这是最关键的一步，~/.openclaw/ 目录包含所有本地数据：凭证、API 密钥、对话记忆、已安装的 Skills。

 

# 查看目录大小（确认再删）
du -sh ~/.openclaw/
 
# 彻底删除
rm -rf ~/.openclaw/

注意：此操作不可逆。如需保留 API 密钥或自定义 Skills，请先备份 ~/.openclaw/.env 和 ~/.openclaw/skills/。

 

第四步：清理 npm 缓存（可选）

 

# 清理 npm 全局缓存中的 openclaw 相关缓存
npm cache clean --force
 
# 或仅清理 openclaw 缓存条目
npm cache ls | grep openclaw

各平台卸载差异对比

操作

macOS

Linux

Windows

守护进程管理

launchctl

systemctl --user

任务计划程序 / 进程管理器

plist/service 路径

~/Library/LaunchAgents/

~/.config/systemd/user/

注册表 / 任务计划程序

配置目录

~/.openclaw/

~/.openclaw/

%USERPROFILE%\.openclaw\

npm 卸载命令

相同

相同

相同（需管理员 PowerShell）

 

如何确认已彻底卸载？

执行以下验证命令，所有命令均应返回空或报错：

 

# 1. 检查命令是否存在
which openclaw && echo "❌ 仍有残留" || echo "✅ npm 包已移除"
 
# 2. 检查配置目录
[ -d ~/.openclaw ] && echo "❌ 配置目录仍存在" || echo "✅ 配置目录已清除"
 
# 3. 检查守护进程（macOS）
launchctl list | grep openclaw && echo "❌ 守护进程仍在运行" || echo "✅ 守护进程已清除"
 
# 4. 检查端口占用（openclaw 默认使用 18789）
lsof -i :18789 && echo "❌ 端口仍被占用" || echo "✅ 端口已释放"

四条全部输出 ✅，说明卸载彻底。

常见问题 FAQ

Q1：守护进程 launchctl unload 报错怎么办？

先用 launchctl list | grep openclaw 确认服务名称，确保 plist 路径正确。如果服务已经不存在但报错，直接删除 plist 文件即可：rm -f ~/Library/LaunchAgents/com.openclaw.*.plist。

Q2：卸载后重新安装，旧数据会恢复吗？

不会自动恢复。如果已删除 ~/.openclaw/ 目录，重新安装后会从零开始初始化。若保留了该目录，重装后旧配置和记忆会自动加载。

Q3：npm uninstall -g openclaw 提示找不到包怎么办？

说明该包可能通过其他方式安装（如 Git 安装法）。检查 ~/.local/bin/openclaw 或 /usr/local/bin/openclaw 是否存在，手动删除对应可执行文件。

Q4：卸载后系统启动变慢问题是否解决？

openclaw 守护进程默认监听 WebSocket 端口 18789 并在后台常驻。完成第一步守护进程卸载后，启动项残留即消除，开机不再自动启动。Q5：Windows 下找不到 openclaw 相关进程怎么排查？

打开任务管理器 → 详细信息，搜索 node.exe 或 openclaw。也可在注册表 HKCU\Software\Microsoft\Windows\CurrentVersion\Run 中检查是否有 openclaw 自启项。

 

小结

openclaw 彻底卸载需要完成停止守护进程 → 卸载 npm 包 → 删除 ~/.openclaw/ 目录 → 清理缓存四个步骤。其中守护进程和配置目录是最常被遗漏的残留来源。本文步骤经 openclaw GitHub 官方仓库文档（2026年3月）及社区实践验证，适用于 openclaw v1.x 及以上版本。