node -v 在 vscode 终端无反应，说明系统 path 未被正确继承，需在内置终端执行 node -v 和 npm -v 验证；windows 常因安装未勾选 add to path 或路径含中文空格，macos/linux 则因 gui 启动不加载 ~/.zshrc，必须用终端执行 code . 启动并彻底退出 vscode 后重开。

node -v 在 VSCode 终端里没反应，说明环境根本没通

不是插件问题，也不是配置问题，是 VSCode 根本没拿到 node 命令。验证唯一有效方式：在 VSCode 内置终端（Ctrl + `）里敲 node -v 和 npm -v —— 两个都必须输出版本号才算过关。

• Windows 用户常见原因：Node.js 安装时没勾选 Add to PATH；或装在含中文、空格的路径（如 C:\我的软件\nodejs\）
• macOS/Linux 用户常见原因：从 Dock 或 Spotlight 启动 VSCode，不会加载 ~/.zshrc；必须在终端执行 code . 启动项目
• 改完环境变量后，必须彻底退出 VSCode（不只是关终端），再重新打开 —— 否则内置终端仍继承旧 PATH

为什么系统终端能跑，VSCode 里却报 'command not found'

VSCode 启动时读取的是“启动那一刻”的系统 PATH，不是你刚在终端里 source ~/.zshrc 后的临时环境。它不监听 shell 配置文件变化。

OC SSH Tunnel Node Recovery

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

下载

• macOS/Linux：确认 which node 输出路径已写入 ~/.zshrc（比如 export PATH="/opt/homebrew/bin:$PATH"），然后用终端执行 code .
• Windows：进“系统属性 → 高级 → 环境变量”，把 Node.js 安装目录（如 C:\Program Files\nodejs\）加到“系统变量”的 PATH，不是用户变量
• 别信“重启电脑”——只要 VSCode 是 GUI 启动的，重启也没用；重点是让它从正确上下文启动

能跑 node -v，但 node app.js 报错 Cannot use import statement outside a module

这不是环境问题，是模块解析类型没对齐。Node 默认按 CommonJS 解析 .js 文件，遇到 import 就崩。

• 检查项目根目录 package.json 是否有 "type": "module" 字段；没有就加，有就确认拼写和引号是英文
• 如果用了 code-runner 插件，默认不识别 package.json 的 type，需手动改其 executorMap："javascript": "node --experimental-specifier-resolution=node $fileName"
• 调试时（launch.json）也依赖这个字段；没声明 "type": "module"，断点可能命中，但 require() 行为会异常、process.cwd() 可能错乱

调试时断点灰色、程序静默退出，大概率是 program 路径写错了

launch.json 里的 program 字段必须指向一个真实存在的、可执行的 .js 文件，且路径必须带工作区变量。

• 正确写法："program": "${workspaceFolder}/src/server.js"（推荐，跨平台安全）
• 错误写法："program": "src/server.js"（VSCode 不会自动补前缀，等同于找当前目录下的 src/server.js）
• TS 项目别指 src/server.ts；要么配 preLaunchTask 编译后指向 dist/server.js，要么用 "runtimeExecutable": "npx" + "runtimeArgs": ["ts-node", "${file}"]
• ESM 项目调试失败，除了 "type": "module"，还要在 env 里加 "NODE_OPTIONS": "--enable-source-maps"，否则源映射常失效

真正卡住人的从来不是 launch.json 语法，而是 node 命令本身是否被 VSCode 看见、program 是否指向一个物理存在的文件、以及 package.json 里那行不起眼的 "type": "module" —— 这三处任一出错，调试都会静默失败。