今天在卸载 OpenClaw 时，终端输出了一段结构奇怪的报错信息。作为一个喜欢刨根问底的人，我决定把这段日志彻底搞清楚。本文详细拆解了 npm 卸载时的错误报告格式、EPERM 错误的含义，以及如何安全处理。

一、现象：一段让人困惑的终端输出

执行卸载命令：

npm uninstall -g openclaw

终端输出了这样一段内容：

npm warn cleanup Failed to remove some directories [
npm warn cleanup   [
npm warn cleanup     'C:\\Users\\Administrator\\AppData\\Roaming\\npm\\node_modules\\.openclaw-oHGnns6k',
npm warn cleanup     [Error: EPERM: operation not permitted, unlink 'C:\Users\Administrator\AppData\Roaming\npm\node_modules\.openclaw-oHGnns6k\node_modules\@mariozechner\clipboard-win32-x64-msvc\clipboard.win32-x64-msvc.node'] {
npm warn cleanup       errno: -4048,
npm warn cleanup       code: 'EPERM',
npm warn cleanup       syscall: 'unlink',
npm warn cleanup       path: 'C:\\Users\\Administrator\\AppData\\Roaming\\npm\\node_modules\\.openclaw-oHGnns6k\\node_modules\\@mariozechner\\clipboard-win32-x64-msvc\\clipboard.win32-x64-msvc.node'
npm warn cleanup     }
npm warn cleanup   ]
npm warn cleanup ]

removed 2 packages in 10s

问题来了：

• 这段输出的结构为什么这么奇怪？

• EPERM 是什么错误？

• 最后明明 removed 2 packages，为什么又显示删除失败？

二、整体结构分析

2.1 先看骨架

npm warn cleanup Failed to remove some directories [
  npm warn cleanup [
    npm warn cleanup     '路径',
    npm warn cleanup     [Error: ...] { ... }
  ]
]
removed 2 packages in 10s

这是一个 数组嵌套数组 的结构：

层级	内容	含义
外层 []	所有失败项的集合	里面可能包含多个删除失败的任务
内层 []	一个具体的失败项	包含：路径 + 错误对象

2.2 为什么是这种格式？

npm 的 cleanup 功能在删除文件时，会把所有失败的操作收集到一个数组中，然后统一打印出来。这样设计的好处是：

• 一次列出所有问题，不用逐个报错

• 结构化的数据便于程序解析（虽然对人类不太友好）

三、内层数组逐项拆解

3.1 内层数组结构

[
  '路径字符串',           // 索引 0：要删除的目录
  Error对象               // 索引 1：删除失败的错误信息
]

3.2 索引 0：路径

'C:\\Users\\Administrator\\AppData\\Roaming\\npm\\node_modules\\.openclaw-oHGnns6k'

这是 npm 为 OpenClaw 创建的临时安装目录。-oHGnns6k 是随机后缀，用于区分不同的安装实例。

3.3 索引 1：Error 对象

[Error: EPERM: operation not permitted, unlink '...clipboard.win32-x64-msvc.node'] {
  errno: -4048,
  code: 'EPERM',
  syscall: 'unlink',
  path: 'C:\\Users\\Administrator\\AppData\\Roaming\\npm\\node_modules\\.openclaw-oHGnns6k\\node_modules\\@mariozechner\\clipboard-win32-x64-msvc\\clipboard.win32-x64-msvc.node'
}

字段	值	含义
message	EPERM: operation not permitted, unlink '...'	错误描述：没有权限执行删除操作
errno	-4048	Windows 系统错误码，对应 EPERM
code	EPERM	错误类型：Operation not permitted
syscall	unlink	执行的系统调用：删除文件
path	完整路径	具体哪个文件操作失败了

关键发现：真正删除失败的是 clipboard.win32-x64-msvc.node 这个文件，而不是整个目录。

四、EPERM 错误详解

4.1 什么是 EPERM？

EPERM 是操作系统返回的错误码，全称是 Error PERMission，表示操作不允许。

在 Windows 上，这个错误通常对应以下情况：

场景	说明
文件被占用	某个进程正在使用该文件（最常见）
文件被锁定	系统或安全软件锁定了文件
权限不足	当前用户没有对该文件的修改权限
只读属性	文件被标记为只读
路径过长	Windows 路径长度超过 260 字符限制（较少见）

4.2 为什么偏偏是这个文件被占用？

clipboard.win32-x64-msvc.node 是一个 Node.js 原生扩展（Native Addon），它编译成了 .node 文件，是二进制动态链接库。

这类文件的特点：

• 通常会被杀毒软件实时扫描锁定

• 可能被正在运行的 Node.js 进程加载占用

• Windows 系统可能会在文件访问后短暂锁定

4.3 errno: -4048 是什么？

Node.js 中的 errno 值是操作系统错误码的负数表示：

错误码	含义
-4048	Windows 下的 EPERM
-4058	ENOENT（文件不存在）
-4092	EISDIR（是目录不是文件）

五、最后的结果分析

removed 2 packages in 10s

虽然过程中有文件删除失败，但 npm 最终还是完成了卸载：

已删除	残留
openclaw 主包	.openclaw-oHGnns6k/clipboard.win32-x64-msvc.node
大部分依赖包	被占用而无法删除的文件

实际效果：OpenClaw 已经被成功卸载，只有那个被占用的 .node 文件残留。

六、如何处理残留文件

6.1 方法一：关闭占用进程后手动删除

# 1. 找到占用该文件的进程（通常与 OpenClaw 相关）
# 首先查看是否有 node 进程还在运行
tasklist | findstr node

# 2. 如果有，结束进程
taskkill /F /IM node.exe

# 3. 然后手动删除残留目录
rmdir /S /Q "C:\Users\Administrator\AppData\Roaming\npm\node_modules\.openclaw-oHGnns6k"

6.2 方法二：重启电脑后删除

最简单的办法——重启电脑后，所有锁定的文件都会被释放，然后直接删除即可。

6.3 方法三：使用第三方工具

如果正常删除还是报错，可以用：

• Unlocker：强制解锁并删除被占用的文件

• IObit Unlocker：类似的工具

• PowerShell 管理员模式：用管理员权限执行删除

七、类比理解

这段输出其实很形象，可以用生活中的场景来类比：

你（npm）想扔一个旧书柜（openclaw 包）。

书柜里有一本杂志（clipboard.win32-x64-msvc.node），被另一个人（某个正在运行的进程）死死按着，不让你拿走。

你只好把书柜里其他能搬走的东西都扔了（removed 2 packages），然后大声向旁边的人汇报：

“报告！书柜扔掉了，但书柜上还有本杂志，那个人不让动（EPERM），我拿不走！”

然后把你看到的场景（路径 + 错误）原样记录在案。

这就是这段输出的完整逻辑——它不是报错，而是 npm 在如实报告：大部分工作完成了，但有个小尾巴没处理干净。

八、总结

问题	答案
为什么输出结构这么奇怪？	npm 把所有失败项收集到数组中统一输出
EPERM 是什么？	操作不允许，通常是文件被占用
卸载成功了吗？	✅ 基本成功，包已卸载
残留文件怎么办？	关闭占用进程后手动删除，或重启电脑
这个输出需要担心吗？	⚠️ 一般不需要，只是警告不是错误

一句话总结：

npm 的 cleanup 警告日志并不是安装失败，而是告诉你 “包已卸载，但有个文件因为被占用没删干净，你自己处理一下”。这是 npm 的善意的提醒，不是报错，更不会影响你的系统正常运行。

---

如果你在开发中也遇到过类似的 EPERM 错误，希望这篇文章能帮你快速定位问题。欢迎在评论区交流讨论！