跳转到内容
OpenClaw Docs

Node.js

OpenClaw 需要 Node 22.19 或更高版本。对于安装、CI 和发布工作流，Node 24 是默认且推荐的运行时。Node 22 仍通过当前的 LTS 版本获得支持。安装程序脚本 会自动检测并安装 Node - 本页面适用于您想自行设置 Node 并确保一切配置正确（版本、PATH、全局安装）的情况。

检查你的版本

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

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

安装 Node

Section titled “安装 Node”

Homebrew（推荐）：

Terminal window
brew install node

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

使用版本管理器 (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. 查找你的全局 npm 前缀

    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 “相关”