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.19+、Node 23.11+ 或 Node 24+。Node 24 是安装、CI 和发布工作流的默认且推荐运行时；Node 22 仍通过活跃 LTS 线获得支持。安装脚本会自动检测并安装 Node；当你想自行设置 Node（版本、PATH、全局安装）时，请使用本页。

检查你的版本

bash
node -v

推荐默认使用 v24.x.x 或更高版本。v22.19.x 或更高版本是受支持的 Node 22 LTS 路径（方便时请升级到 Node 24）。不支持 v23.11.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 prefix

    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 的全局 prefix 切换到用户可写目录：

    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