这是环境变量配置问题，需检查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，绕过全局命令注册环节

真正麻烦的从来不是装软件，而是路径和上下文的错位——VSCode 的终端、系统终端、调试器、nvm、自定义 npm prefix，它们各自维护一套“我认得的 node 在哪”的逻辑。盯住 where node 和 npm config get prefix 这两条命令的输出，比反复重装更省时间。