VSCode里node命令报错根本原因是PATH未正确继承，需重启VSCode生效；Windows用户应将Node安装路径加入系统环境变量，并在settings.json中配置"terminal.integrated.env.windows"注入PATH，调试时还需在launch.json中显式设置runtimeExecutable指向node.exe绝对路径。

VSCode 里 node 命令报错，不是因为没装 Node，而是 PATH 没导进去

离线环境下，VSCode 启动时不会自动继承系统环境变量（尤其是 Windows 上通过 MSI 安装的 Node.js，PATH 可能只写进用户级变量，而 VSCode 以不同会话启动时读不到）。常见现象是终端里手动运行 node -v 正常，但在 VSCode 内置终端里提示 'node' is not recognized。

• 先确认 Node 已离线安装完成：在任意 CMD/PowerShell 中执行 where node，得到类似 C:Program Files odejs ode.exe 的路径
• VSCode 不读取实时修改的 PATH，必须重启 VSCode 才生效——改完系统 PATH 后别只刷新终端，要彻底关闭再打开
• Windows 用户注意：如果用的是「Node.js 官方 MSI 安装包」，默认勾选了「Add to PATH」，但有时仅写入当前用户 PATH；建议手动把 C:Program Files odejs 加到「系统环境变量」PATH 中，避免权限或会话隔离问题

不用联网也能让 VSCode 找到 node：直接配 terminal.integrated.env.windows

这是离线最稳的方案——绕过系统 PATH，让 VSCode 终端自己注入环境变量。适用于已知 Node 安装路径但无法改系统变量（比如受限账户）的场景。

OC SSH Tunnel Node Recovery

诊断并恢复通过 SSH 隧道连接的 OpenClaw 节点。用于解决配对必需错误、隧道冲突、远程端点错误以及 SSH 目标配置错误等问题。

下载

• 打开 VSCode 设置（Ctrl + ,），搜索 terminal.integrated.env.windows
• 点击「编辑 in settings.json」，添加如下字段（路径按你实际安装位置调整）：

  "terminal.integrated.env.windows": {
      "PATH": "C:\Program Files\nodejs;${env:PATH}"
  }

• 注意反斜杠要双写（\），且必须保留 ${env:PATH}，否则会丢掉其他必要路径（比如 git、python）
• 改完保存，关闭所有终端面板，再打开新终端——此时 node -v 和 npm -v 都应正常返回

调试时提示 Cannot find runtime 'node'？配 runtimeExecutable 就行

VSCode 调试器（launch.json）默认依赖 PATH 查找 node，离线时容易失败。错误信息通常出现在 F5 启动后弹窗或 debug 控制台里。

• 在项目根目录的 .vscode/launch.json 中，给对应配置加 runtimeExecutable 字段：

  "configurations": [{
      "type": "node",
      "request": "launch",
      "name": "Launch Program",
      "runtimeExecutable": "C:\Program Files\nodejs\node.exe",
      "program": "${file}"
  }]

• 路径必须是绝对路径，且指向 node.exe（不是文件夹）；Mac/Linux 用正斜杠，如 /usr/local/bin/node
• 如果同时用了 npm 脚本调试（如 "request": "launch", "runtimeVersion": "18.17.0"），离线时 runtimeVersion 无效，必须用 runtimeExecutable 替代

离线安装 npm 包？npm install 报 404 或 ETIMEDOUT 不代表没网就完全不能装

只要包已缓存在本地（比如之前联网时装过），npm install 默认优先走本地 cache，不发网络请求。真正卡住往往是因为 lockfile 里记录了 registry 地址，npm 仍尝试验证完整性。

• 先检查缓存是否存在：运行 npm config get cache，然后去该路径下看有没有对应包的 tarball（如 lodash 对应 lodash-4.17.21.tgz）
• 临时禁用 registry 校验：执行 npm install --no-package-lock --offline（--offline 是关键）
• 若仍失败，可复制另一台机器上完整的 node_modules 文件夹过来，然后运行 npm rebuild（需同架构、同 Node 版本）
• 注意：package-lock.json 里的 integrity 字段离线时无法校验，建议提前删掉或设 "integrity": ""（不推荐长期这么做）

离线配 Node 最容易被忽略的点：VSCode 窗口启动方式。从开始菜单或桌面快捷方式启动，和从命令行用 code . 启动，继承的环境变量可能不同——后者会继承当前 shell 的 PATH，前者只认系统级变量。真要稳妥，两个地方都得配。