Node.js¶

OpenClaw требует Node версии 22 или новее. Скрипт установщика автоматически обнаружит и установит Node — эта страница предназначена для случаев, когда вы хотите настроить Node самостоятельно и убедиться, что всё подключено корректно (версии, PATH, глобальные установки).

Проверка версии¶

node -v

Если выводится v22.x.x или выше — всё в порядке. Если Node не установлен или версия слишком старая, выберите способ установки ниже.

Установка Node¶

Homebrew (рекомендуется):

````
```bash
brew install node
```

Либо загрузите установщик для macOS с [nodejs.org](https://nodejs.org/).
````

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
```

Либо загрузите установщик для Windows с [nodejs.org](https://nodejs.org/).
````

Менеджеры версий позволяют легко переключаться между версиями Node. Популярные варианты:

• fnm — быстрый, кроссплатформенный
• nvm — широко используется на macOS/Linux
• mise — полиглот (Node, Python, Ruby и т. д.)

Пример с fnm:

fnm install 22
fnm use 22

Убедитесь, что менеджер версий инициализируется в файле запуска вашей оболочки (~/.zshrc или ~/.bashrc). Если это не так, openclaw может не находиться в новых сессиях терминала, поскольку PATH не будет включать каталог bin Node.

Устранение неполадок¶

openclaw: command not found¶

Это почти всегда означает, что каталог глобальных бинарников npm не добавлен в 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"
        ```

        Затем откройте новый терминал (или выполните `rehash` в zsh / `hash -r` в bash).
      </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, чтобы сделать изменение постоянным.