GNVM是独立Windows命令行工具，非VSCode插件；需先系统级安装配置（gnvm.exe放无中文/空格路径、加至系统Path）、执行gnvm use指定版本并重启VSCode终端，才能使VSCode识别对应node/npm。
GNVM 不是 VSCode 的插件，也不能在 VSCode 里直接“安装 Node 环境”——它是个独立的 Windows 命令行工具，必须先在系统级完成安装和配置，VSCode 才能感知并使用对应版本的 node 和 npm。
gnvm.exe 下载与路径放置
GNVM 是单文件（gnvm.exe），不依赖 .NET 或 Go 运行时，但对路径有硬性要求：
- 路径不能含中文、空格或特殊符号（如
D:\NodeJs可以，D:\我的工具\node不行） - 建议放在盘符根目录下便于管理，比如
D:\gnvm - 下载后别双击运行，而是把它加进系统
Path环境变量（不是用户变量，是系统变量里的Path） - 验证是否生效：关掉所有 CMD/PowerShell/VSCode 终端，新开一个 CMD，输入
gnvm version—— 能输出版本号才算成功
gnvm install 后 node 不在 PATH 中？
常见现象：执行 gnvm install 18.20.4 成功，但紧接着 node -v 报错“不是内部或外部命令”。这是因为：
Zenlink - Node SDK for ZenHeart
下载
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
-
gnvm install只下载并解压 Node 二进制到%USERPROFILE%\.gnvm\versions\node\v18.20.4\（默认位置），并不自动注册到系统PATH - 必须手动执行
gnvm use 18.20.4，这一步才会把该版本的bin目录写入当前 shell 的PATH - VSCode 的集成终端默认继承系统环境变量，但只读取启动时的快照；如果 VSCode 已打开，需重启终端（或整个 VSCode）才能加载新
PATH
VSCode 终端识别不到 gnvm 切换的 node 版本
即使 gnvm use 成功，VSCode 里仍可能看到旧版本或报错，原因通常是：
- VSCode 启动时读取的是系统环境变量快照，而
gnvm use修改的是当前 CMD 进程的临时PATH，未持久化到系统级 - 解决办法：在 VSCode 设置中启用
terminal.integrated.inheritEnv（设为true），并确保 VSCode 是从已执行过gnvm use的 CMD 中启动的 - 更稳妥的做法：用
gnvm alias default 18.20.4设置默认版本，再重启 VSCode —— 这样每次新终端都会自动加载该版本 - 验证方式：在 VSCode 集成终端中运行
where node（Windows），输出路径应指向.gnvm\versions\node\...，而非C:\Program Files\nodejs\
npm 版本与 node 版本不匹配怎么办
GNVM 安装的 Node 自带对应 npm，但有时项目需要降级 npm（例如某些老脚手架不兼容 npm@9+）：
- 不要用
npm install -g npm@6.14.18全局覆盖——这会污染当前node自带的 npm，且gnvm use切换版本后失效 - 正确做法：在项目根目录下执行
npx npm@6.14.18 install，或用npm install --save-dev npm@6.14.18锁定本地 npm 版本 - 若必须全局降级，应在
gnvm use指定版本后，立即执行npm install -g npm@6.14.18，然后立刻gnvm use切回同一版本，强制重载 PATH
GNVM 的核心逻辑是“按需下载 + 进程级 PATH 注入”，它不修改系统注册表、不写入系统级环境变量，所以所有操作都围绕终端生命周期展开。VSCode 是否能用上，取决于你启动它的上下文是否承载了正确的 PATH 快照——这点最容易被忽略。
