WSL2 安装 OpenClaw 权限报错 EACCES

症状

在 WSL2 中运行 npm install -g openclaw 报错：

npm ERR! code EACCES
npm ERR! syscall mkdir
npm ERR! path /usr/local/lib/node_modules/openclaw
npm ERR! errno -13

或者安装后 openclaw 命令找不到。

原因

WSL2 中 npm 全局目录默认在系统目录，普通用户没有写入权限。另外 PATH 可能没有包含 npm 的 bin 目录。

解法

一次性修复（推荐）

# 创建用户级 npm 全局目录
mkdir -p ~/.npm-global
npm config set prefix "~/.npm-global"

# 添加到 PATH
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# 重新安装
npm install -g openclaw@latest
openclaw --version

重要提示

• 不要用 sudo npm install — 会导致后续权限问题更多
• 不要在 Windows 路径（/mnt/c/）下操作 — 跨文件系统极慢
• 把工作目录放在 ~/ 下 — Linux 原生路径性能好

验证修复

which openclaw          # 应显示 ~/.npm-global/bin/openclaw
openclaw --version      # 应正常显示版本号