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

​
Проверьте свою версию

node -v
Если команда выводит v24.x.x или выше, вы используете рекомендуемую версию по умолчанию. Если она выводит v22.19.x или выше, вы используете поддерживаемый путь Node 22 LTS, но мы все равно рекомендуем перейти на Node 24, когда это будет удобно. Если Node не установлен или версия слишком старая, выберите способ установки ниже.

​
Установите Node

Homebrew (рекомендуется):
brew install node
Или скачайте установщик для macOS с nodejs.org.
Менеджеры версий позволяют легко переключаться между версиями 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

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, чтобы сделать изменение постоянным.

​
Связанные материалы