Перейти к основному содержанию

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

Find your global npm prefix

npm prefix -g
2

Check if it's on your PATH

echo "$PATH"

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

Add it to your shell startup file

Добавьте в ~/.zshrc или ~/.bashrc:
export PATH="$(npm prefix -g)/bin:$PATH"
Затем откройте новый терминал (или выполните rehash в zsh / hash -r в bash).

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