根本原因是VSCode启动时未加载shell配置，导致nvm、volta等工具不可用且调试器沿用旧Node版本；需启用terminal.integrated.inheritEnv为true并彻底重启VSCode，再在launch.json中配置"runtimeExecutable": "${env:NVM_BIN}/node"，最后重启TypeScript Server以同步语言服务。
VSCode 里 Node 版本错乱、调试跑旧版、终端找不到 nvm 或 volta，根本不是插件或配置文件写得不够多，而是环境变量没被正确加载——VSCode 启动时的进程环境和你在终端里手动执行命令的环境，压根不是一回事。
VSCode 终端里 nvm 命令不存在
这不是 nvm 没装好，是 VSCode 启动时没读你的 ~/.zshrc 或 ~/.bash_profile，PATH 里压根没加 ~/.nvm/bin。
- 打开 VSCode 设置（
Cmd+,），搜terminal.integrated.inheritEnv，设为true - 改完必须完全退出 VSCode（不只是关窗口），再重开
- 新开集成终端，运行
which nvm；如果返回~/.nvm/nvm.sh，说明加载成功 - 如果仍不行，检查你实际用的 shell：macOS 默认是
zsh，对应设置项是terminal.integrated.env.zsh，手动加NVM_DIR和PATH：
"terminal.integrated.env.zsh": {
"NVM_DIR": "/Users/you/.nvm",
"PATH": "/Users/you/.nvm/bin:${env:PATH}"
}
Windows 用户请直接用 nvm-windows，并手动把 C:\Users\you\AppData\Roaming\nvm 加进系统 PATH，重启 VSCode。
nvm use 成功但 F5 调试还是旧版本
调试器不继承终端环境，它启动时只认 VSCode 启动那一刻的 PATH。你在终端里 nvm use 18.17.0，对调试器完全无效。
OC SSH Tunnel Node Recovery
下载
诊断并恢复通过 SSH 隧道连接的 OpenClaw 节点。用于解决配对必需错误、隧道冲突、远程端点错误以及 SSH 目标配置错误等问题。
- 在
.vscode/launch.json中显式指定"runtimeExecutable": "${env:NVM_BIN}/node" - 确保
${env:NVM_BIN}有值：在集成终端里运行echo $NVM_BIN，应输出类似/Users/you/.nvm/versions/node/v18.17.0/bin - 别硬编码路径，比如
"runtimeExecutable": "/Users/xxx/.nvm/versions/node/v18.17.0/bin/node"—— 换机器就挂 - 如果
$NVM_BIN为空，说明nvm没加载成功，回到上一步检查inheritEnv和 shell 初始化
Volta 不自动切 Node 版本
Volta 不会监听目录变化，也不会自动生成 .node-version。它只读，不写。没这个文件，它就用默认版本（通常是最新 stable）。
- 在项目根目录运行
volta pin node@18.19.0（注意：不支持^18这种范围写法） - 确认 VSCode 终端启动的是 login shell：
zsh -l或bash -l；macOS 上可在设置里设terminal.integrated.defaultProfile.osx为zsh - 检查
~/.zshrc或~/.zprofile是否包含 Volta 提示的那行：export PATH="$HOME/.volta/bin:$PATH" - 验证：
volta list node应显示已安装版本，which node应指向~/.volta/bin/node
JS/TS 语言服务报 Node 版本不匹配
VSCode 的 TypeScript Server 启动时固定读一个 Node 可执行文件，跟终端无关。改了 nvm use 或 volta pin，它不会自动重启或重载。
- 按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Win/Linux），输入Typescript: Restart TS server手动触发 - 或者直接关掉 VSCode 再重开——这是最稳的办法
- 如果你用
volta，且which node已指向.volta/bin/node，重启 TS Server 后，类型检查和 IntelliSense 就会按.node-version里的版本解析 - 注意：
.nvmrc对 Volta 有效（只读），但.node-version对nvm无效（nvm不读它）
真正卡住人的地方从来不是“怎么配”，而是“哪个环节的环境没刷新”——终端、调试器、语言服务、甚至 VSCode GUI 主进程，各自维护一套环境变量快照。改完任何一项，都得明确知道该重启什么：终端？调试会话？TS Server？还是整个 VSCode？
