跳转到内容
OpenClaw Docs

Node.js

Node.js

Section titled “Node.js”

OpenClaw 需要 Node 22.14 或更新版本。Node 24 是安装、CI 和发布工作流的默认及推荐运行时。Node 22 仍然通过活跃 LTS 线路获得支持。安装程序脚本 将自动检测并安装 Node — 本页面适用于您想要自行设置 Node 并确保一切配置正确（版本、PATH、全局安装）的情况。

检查您的版本

Section titled “检查您的版本”
Terminal window
node -v

如果打印出 v24.x.x 或更高版本，说明您处于推荐的默认版本上。如果打印出 v22.14.x 或更高版本，说明您处于受支持的 Node 22 LTS 线路上，但我们仍然建议您在方便时升级到 Node 24。如果未安装 Node 或版本过旧，请选择下方的安装方法。

安装 Node

Section titled “安装 Node”

Homebrew（推荐）：

Terminal window
brew install node

或者从 nodejs.org 下载 macOS 安装程序。

Using a version manager (nvm, fnm, mise, asdf)

版本管理器让你可以轻松切换 Node 版本。热门选项包括：

  • fnm — 快速，跨平台
  • nvm — 在 macOS/Linux 上广泛使用
  • mise — 多语言支持（Node、Python、Ruby 等）

fnm 示例：

Terminal window
fnm install 24
fnm use 24

故障排除

Section titled “故障排除”

openclaw: command not found

Section titled “openclaw: command not found”

这几乎总是意味着 npm 的全局 bin 目录不在您的 PATH 中。

  1. Find your global npm prefix

    Terminal window
    npm prefix -g

  2. 检查它是否在您的 PATH 中

    Terminal window
    echo "$PATH"

    在输出中查找 `

    /bin(macOS/Linux) 或

    ` (Windows)。

  3. 将其添加到您的 shell 启动文件

    添加到 ~/.zshrc 或 ~/.bashrc：

    Terminal window
    export PATH="$(npm prefix -g)/bin:$PATH"

    然后打开一个新终端 (或者在 zsh 中运行 rehash / 在 bash 中运行 hash -r)。

npm install -g 上的权限错误

Section titled “npm install -g 上的权限错误”

如果您看到 EACCES 错误，请将 npm 的全局前缀切换到用户可写的目录：

Terminal window
mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"

将 export PATH=... 行添加到您的 ~/.bashrc 或 ~/.zshrc 以使其永久生效。

相关

Section titled “相关”