这是环境变量配置问题，需检查path是否包含node.js安装路径、确认python和vs build tools已安装、在vscode中显式指定runtimeexecutable、将cnpm/pnpm所在.bin目录加入path，或改用npx调用。
node -v 和 npm -v 报“不是内部命令”
这是最典型的环境变量失效问题，不是 Node 没装好，而是系统找不到 node.exe 和 npm.cmd。安装时勾选了 “Add to PATH” 也不代表一定生效——尤其是你中途重启过终端、或用的是 PowerShell 而非 CMD。
- 先执行
refreshenv（仅 PowerShell 有效），再试node -v - 若仍失败，手动检查系统 Path：右键“此电脑”→属性→高级系统设置→环境变量→用户变量/系统变量中的
Path，确认包含类似C:Program Files odejs的路径（注意路径末尾不能有反斜杠） - 特别注意：如果之前装过旧版 Node.js，卸载后残留的旧路径可能还在 Path 里，把它删掉再重试
npm install 总卡在 node-gyp rebuild 或 permission denied
node-gyp 是编译原生模块的工具，Windows 下它依赖 Python 和 VS Build Tools。报错不是网络问题，而是构建环境缺失。
Zenlink - Node SDK for ZenHeart
下载
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
- 安装 Node.js 时务必勾选
Automatically install the necessary tools（含 Python 3.10+ 和 Visual Studio Build Tools） - 若已安装但依然失败，运行 PowerShell（管理员权限）执行：
npm config set python "C:Python310python.exe"（路径按你实际 Python 安装位置调整） - 避免全局使用
sudo或管理员权限运行npm install；改用npm config set prefix指向用户目录下的路径（如%USERPROFILE%AppDataRoaming pm），再把该路径加进 Path
VSCode 终端里 node 命令正常，但调试时提示 “Cannot find runtime 'node'”
VSCode 调试器默认读取系统 PATH，但如果你用的是自定义 Node 安装路径（比如装在 D: odejs），或者用了 nvm 切换版本，调试配置就可能找不到可执行文件。
- 打开项目根目录下的
.vscode/launch.json，在配置中显式指定runtimeExecutable，例如："runtimeExecutable": "D:\nodejs\node.exe" - 不要依赖
node命令自动解析；尤其当多个 Node 版本共存时，调试器不会主动读取 nvm 当前激活版本 - 验证方式：在调试配置里加一行
"env": {"PATH": "D:\nodejs;${env:PATH}"}，强制注入路径
cnpm 或 pnpm 安装后命令不识别
cnpm 和 pnpm 是全局安装的 CLI 工具，它们的可执行文件路径不一定在系统 PATH 中——尤其当你修改过 npm 全局路径后。
- 先查安装位置：
npm config get prefix，然后看该路径下的bin目录（Windows 下是node_modules.bin）是否存在cnpm.cmd或pnpm.cmd - 如果存在，就把
${prefix} ode_modules.bin（注意是带.bin的完整路径）加进系统 Path - 更稳妥的做法是直接用
npx cnpm install或npx pnpm install，绕过全局命令注册环节
where node 和 npm config get prefix 这两条命令的输出，比反复重装更省时间。
