OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Node 运行时

Node.js

OpenClaw 要求使用 Node 22.22.3+、Node 24.15+ 或 Node 25.9+。对于安装、CI 和发布工作流，Node 24 是默认且推荐的运行时；Node 22 仍通过活跃的 LTS 版本线获得支持。不支持 Node 23。安装程序脚本会自动检测并安装 Node——如果你想自行设置 Node（版本、PATH、全局安装），请参考本页面。

检查版本

bash
node -v

v24.15.0 或更新的 24.x 版本是推荐的默认选择。v22.22.3 或更新的 22.x 版本是受支持的 Node 22 LTS 路径；Node v25.9.0+ 也受支持。不支持 Node 23。如果未安装 Node 或版本不在支持范围内，请选择下方的安装方式。

安装 Node

macOS

Homebrew（推荐）：

bash
brew install node

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

Linux

Ubuntu / Debian：

bash
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -sudo apt-get install -y nodejs

Fedora / RHEL：

bash
sudo dnf install nodejs

或使用版本管理器（见下文）。

Windows

winget（推荐）：

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey：

powershell
choco install nodejs-lts

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

使用版本管理器（nvm、fnm、mise、asdf）

版本管理器可让你轻松切换 Node 版本。常用选项包括：

  • fnm - 快速、跨平台
  • nvm - 在 macOS/Linux 上广泛使用
  • mise - 多语言版本管理器（Node、Python、Ruby 等）

使用 fnm 的示例：

bash
fnm install 24fnm use 24

故障排查

openclaw: command not found

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

  • 查找 npm 的全局前缀

    bash
    npm prefix -g

  • 检查它是否在 PATH 中

    bash
    echo "$PATH"

    在输出中查找 <npm-prefix>/bin（macOS/Linux）或 <npm-prefix>（Windows）。

  • 将其添加到 shell 启动文件

    macOS / Linux

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

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

    然后打开新终端（或在 zsh 中运行 rehash / 在 bash 中运行 hash -r）。

    Windows

    通过 Settings → System → Environment Variables 将 npm prefix -g 的输出添加到系统 PATH。

    • npm install -g 上的权限错误（Linux）

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

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

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

    相关内容

    Was this useful?
    On this page

    On this page