Node.js

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

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

node -v

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

Установка Node

macOS
Linux
Windows

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/).
````

Using a version manager (nvm, fnm, mise, asdf)

Менеджеры версий позволяют легко переключаться между версиями 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.

Find your global npm prefix

npm prefix -g

Check if it's on your PATH

echo "$PATH"

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

Add it to your shell startup file

macOS / Linux
Windows

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

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

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

Добавьте вывод npm prefix -g в системный PATH через «Параметры → Система → Переменные среды».

Ошибки прав доступа на `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, чтобы сделать изменение постоянным.

Помощь

Сообщество

Среда и отладка

Node runtime

Внутренние механизмы сжатия

Настройка для разработчиков

Мета документации

Node.js

Node.js

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

Установка Node

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

`openclaw: command not found`

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

​Node.js

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

​Установка Node

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

​openclaw: command not found

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

Node.js

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

Установка Node

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

`openclaw: command not found`

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