macos配置node.js全局路径变量的核心是将/usr/local/bin和~/.npm-global/bin加入$path，并根据shell类型编辑~/.zshrc或~/.bash_profile；需执行source命令生效，再用which、node -v、npm -v和echo $path验证。

macos 上配置 node.js 全局路径变量，核心是把 node.js 的可执行文件目录（如 /usr/local/bin）和 npm 全局模块的 bin 目录（如 ~/.npm-global/bin）正确加入 $path，并确保 shell 能识别它们。

确认当前 Shell 类型

终端中运行：

echo $SHELL

输出 /bin/zsh 表示使用 zsh（macOS Catalina 及之后默认），输出 /bin/bash 则为 bash。后续配置文件需对应：

• zsh → 编辑 ~/.zshrc（推荐）或 ~/.zprofile
• bash → 编辑 ~/.bash_profile（登录时加载，更稳妥）

添加 Node.js 默认路径到 PATH

Node.js 官方安装包或 Homebrew 默认将 node 和 npm 放在 /usr/local/bin。在对应配置文件末尾追加：

export PATH="/usr/local/bin:$PATH"

保存后运行：

OC SSH Tunnel Node Recovery

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

下载

source ~/.zshrc

或（bash 用户）：

source ~/.bash_profile

自定义 npm 全局安装路径（推荐）

避免权限问题，建议将 npm 全局模块装到用户目录下：

• 创建目录：mkdir -p ~/.npm-global
• 配置 npm 使用该目录：npm config set prefix '~/.npm-global'
• 把它的 bin 加入 PATH（同样加在 ~/.zshrc 或 ~/.bash_profile 中）：
  export PATH=~/.npm-global/bin:$PATH

完成后重新加载配置，再执行 npm config get prefix 和 echo $PATH 验证是否生效。

验证是否成功

依次运行以下命令，全部应有合理输出：

• which node → 应返回 /usr/local/bin/node 或类似路径
• which npm → 同上，或指向 ~/.npm-global/bin/npm（若已自定义）
• node -v && npm -v → 显示版本号
• echo $PATH → 输出中应包含你添加的路径