1 安装微信等插件报错 SafeOpenError: path is not a regular file under root
$ npx -y @tencent-weixin/openclaw-weixin-cli@latest install
[openclaw-weixin] 已找到本地安装的 openclaw
[openclaw-weixin] 正在安装插件...
[openclaw-weixin] 插件安装失败，请手动执行：
failed to extract archive: SafeOpenError: path is not a regular file under root
openclaw plugins install "@tencent-weixin/openclaw-weixin"
$ openclaw plugins install "@tencent-weixin/openclaw-weixin"
10:09:54 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
10:09:54 [plugins] feishu_chat: Registered feishu_chat tool
10:09:54 [plugins] feishu_wiki: Registered feishu_wiki tool
10:09:54 [plugins] feishu_drive: Registered feishu_drive tool
10:09:54 [plugins] feishu_bitable: Registered bitable tools
10:09:54 [plugins] [content-security] 状态目录: /Users/yangjie01/.openclaw
10:09:54 [plugins] [content-security] 注册失败：缺少必要配置。endpoint=<https://jprx.m.qq.com/data/4064/forward>, token=空
[wechat-access] 腾讯通路插件已注册
🦞 OpenClaw 2026.3.11 (29dc654) — No $999 stand required.
Downloading @tencent-weixin/openclaw-weixin…
Extracting /var/folders/ls/4yw8p6vx7vv1xs_lt4h9rx48g4lvj2/T/openclaw-npm-pack-dUwsva/tencent-weixin-openclaw-weixin-1.0.2.tgz…
failed to extract archive: SafeOpenError: path is not a regular file under root
通过 claude-4.6-Sonnet 解决
问题总结：OpenClaw 插件安装失败
根本原因
OpenClaw 在 macOS 上安装插件时，使用了一个 Python 脚本来做原子文件写入（runPinnedWriteHelper），该脚本用到了 os.open(path, flags, dir_fd=dir_fd) 的 dir_fd 参数。
dir_fd 是 Linux 特有特性，macOS 的 Python 不支持，导致 Python 脚本崩溃：
NotImplementedError: dir_fd unavailable on this platform
这个错误被层层包装后，以误导性的错误信息呈现给用户：
failed to extract archive: SafeOpenError: path is not a regular file under root
解决方案
⚠️ 将以下路径中的
{USERNAME}替换为你的用户名，{NODE_VERSION}替换为你的 Node.js 版本（如v24.14.0）
/Users/{USERNAME}/.nvm/versions/node/{NODE_VERSION}/lib/node_modules/openclaw/dist/
Patch 1 — install-safe-path-xC--QTS5.js：跳过非文件条目
sed -i '' 's/if (!sourceStat.isFile()) throw new Error(`archive staging contains unsupported entry: ${originalPath}`);/if (!sourceStat.isFile()) { continue; }/' \
/Users/{USERNAME}/.nvm/versions/node/{NODE_VERSION}/lib/node_modules/openclaw/dist/install-safe-path-xC--QTS5.js
Patch 2 — windows-spawn-oQqooioe.js：新建文件时跳过 isFile 检查
sed -i '' '469s/if (!stat.isFile()) throw new SafeOpenError("invalid-path", "path is not a regular file under root");/if (!stat.isFile() && !createdForWrite) throw new SafeOpenError("invalid-path", "path is not a regular file under root");/' \
/Users/{USERNAME}/.nvm/versions/node/{NODE_VERSION}/lib/node_modules/openclaw/dist/windows-spawn-oQqooioe.js
sed -i '' '473s/if (lstat.isSymbolicLink() || !lstat.isFile()) throw new SafeOpenError("invalid-path", "path is not a regular file under root");/if (!createdForWrite && (lstat.isSymbolicLink() || !lstat.isFile())) throw new SafeOpenError("invalid-path", "path is not a regular file under root");/' \
/Users/{USERNAME}/.nvm/versions/node/{NODE_VERSION}/lib/node_modules/openclaw/dist/windows-spawn-oQqooioe.js
Patch 3 — windows-spawn-oQqooioe.js：强制跳过 Python，走 Node.js fallback
sed -i '' 's/const child = spawn("python3",/const { EventEmitter } = await import("node:events"); const child = Object.assign(new EventEmitter(), { stdin: null, stdout: Object.assign(new EventEmitter(), { setEncoding: ()=>{} }), stderr: Object.assign(new EventEmitter(), { setEncoding: ()=>{} }), kill: ()=>{} }); setTimeout(()=>child.emit("close", 0, null), 0); // patched\nif (false) spawn("python3",/' \
/Users/{USERNAME}/.nvm/versions/node/{NODE_VERSION}/lib/node_modules/openclaw/dist/windows-spawn-oQqooioe.js
最终安装
# 清理残留配置（如有）
node -e "
const fs = require('fs');
const cfg = JSON.parse(fs.readFileSync(process.env.HOME + '/.openclaw/openclaw.json', 'utf8'));
cfg.plugins.allow = cfg.plugins.allow.filter(x => x !== 'openclaw-weixin');
delete cfg.plugins.entries['openclaw-weixin'];
delete cfg.plugins.installs['openclaw-weixin'];
fs.writeFileSync(process.env.HOME + '/.openclaw/openclaw.json', JSON.stringify(cfg, null, 2));
"
# 安装插件
openclaw plugins install "@tencent-weixin/openclaw-weixin"
# 扫码注册
npx -y @tencent-weixin/openclaw-weixin-cli@latest install
注意事项
- OpenClaw 升级后 patch 会失效，需重新执行以上三个 patch
- 这是 OpenClaw 的 bug，建议向官方反馈：macOS 上应优先检测平台是否支持
dir_fd，不支持时直接走 Node.js fallback
