Node.js

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

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

node -v

Если выводится v24.x.x или выше — вы на рекомендуемой версии. Если v22.16.x или выше — вы на поддерживаемой Node 22 LTS, но мы рекомендуем обновиться до Node 24 при удобном случае. Если Node не установлен или версия слишком старая, выберите способ установки ниже.

Установка Node

macOS

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

```bash
brew install node
```

Или скачайте установщик macOS с [nodejs.org](https://nodejs.org/).

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

Или скачайте установщик Windows с [nodejs.org](https://nodejs.org/).

Менеджеры версий (nvm, fnm, mise, asdf)

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

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

Пример с fnm:

fnm install 24
fnm use 24

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

Решение проблем

`openclaw: command not found`

Почти всегда это означает, что глобальный каталог bin npm не в PATH.

Шаг 1: Найдите глобальный prefix npm

```bash
npm prefix -g
```

Шаг 2: Проверьте, есть ли он в PATH

```bash
echo "$PATH"
```

Ищите `<npm-prefix>/bin` (macOS/Linux) или `<npm-prefix>` (Windows) в выводе.

Шаг 3: Добавьте в файл запуска оболочки

  #### macOS / Linux
    Добавьте в `~/.zshrc` или `~/.bashrc`:

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

    Затем откройте новый терминал (или выполните `rehash` в zsh / `hash -r` в bash).

  #### Windows
    Добавьте вывод `npm prefix -g` в системный PATH через Настройки → Система → Переменные среды.

Ошибки прав доступа при `npm install -g` (Linux)

Если видите ошибки EACCES, переключите глобальный prefix npm на каталог, доступный пользователю для записи:

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

Добавьте строку export PATH=... в ~/.bashrc или ~/.zshrc для постоянного применения.