Node.js

OpenClaw 需要 Node 22 或更高版本。安装脚本会自动检测和安装 Node —— 本页面适用于你想自己设置 Node 并确保一切正确连接的情况（版本、PATH、全局安装）。

检查你的版本

node -v

如果打印 v22.x.x 或更高版本，就可以了。如果 Node 未安装或版本太旧，请在下面选择安装方法。

安装 Node

**Homebrew**（推荐）：

```bash
brew install node
```

或从 [nodejs.org](https://nodejs.org/) 下载 macOS 安装程序。

**Ubuntu / Debian：**

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

**Fedora / RHEL：**

```bash
sudo dnf install nodejs
```

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

**winget**（推荐）：

```powershell
winget install OpenJS.NodeJS.LTS
```

**Chocolatey：**

```powershell
choco install nodejs-lts
```

或从 [nodejs.org](https://nodejs.org/) 下载 Windows 安装程序。

版本管理器让你可以轻松切换 Node 版本。流行选项：

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

使用 fnm 的示例：

fnm install 22
fnm use 22

确保你的版本管理器在你的 shell 启动文件（`~/.zshrc` 或 `~/.bashrc`）中被初始化。如果不是，`openclaw` 可能在新的终端会话中找不到，因为 PATH 不包含 Node 的 bin 目录。

故障排除

`openclaw: command not found`

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

```bash npm prefix -g ``` ```bash echo "$PATH" ```

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

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

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

    然后打开一个新终端（或在 zsh 中运行 `rehash` / 在 bash 中运行 `hash -r`）。
  </Tab>
  <Tab title="Windows">
    通过设置 → 系统 → 环境变量将 `npm prefix -g` 的输出添加到系统 PATH。
  </Tab>
</Tabs>

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

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

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

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