报错字典 / openclaw / npm EACCES

装到一半权限被拒

安装目录落在中文用户名或受保护路径下,npm 写不进去。

原始报错

2026-11-05
npm error code EACCES / npm error syscall mkdir ... EPERM

原因

Windows 用户目录含中文或空格时,npm 及其生命周期脚本会在创建目录这一步报权限错。这不是权限不够,是路径本身的问题。

解法

  1. 不要装到用户目录,改用固定的纯英文短路径,例如 C:\AgentHub\packages
  2. 用 --prefix 指定安装前缀,避开系统 npm 目录
  3. 路径别超过 200 字符,Windows 有 260 的上限
  4. 这一步做完,环境问题就少了一大半,整合包预置的沙箱就是为它准备的