Перейти до основного вмісту
OpenClaw потребує Node 22.19+, Node 23.11+ або Node 24+. Node 24 є типовим і рекомендованим середовищем виконання для встановлень, CI та робочих процесів релізу. Node 22 залишається підтримуваним через активну гілку LTS. Скрипт встановлення автоматично виявить і встановить Node - ця сторінка для випадків, коли ви хочете налаштувати Node самостійно й переконатися, що все правильно підключено (версії, PATH, глобальні встановлення).

​
Перевірте свою версію

node -v
Якщо це виводить v24.x.x або вище, ви використовуєте рекомендований типовий варіант. Якщо це виводить v22.19.x або вище, ви використовуєте підтримуваний шлях Node 22 LTS, але ми все одно рекомендуємо перейти на Node 24, коли буде зручно. Версії Node 23 до v23.11.0 не підтримуються. Якщо 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

Знайдіть свій глобальний префікс npm

npm prefix -g
2

Перевірте, чи він є у вашому PATH

echo "$PATH"
Знайдіть <npm-prefix>/bin (macOS/Linux) або <npm-prefix> (Windows) у виводі.
3

Додайте його до файлу запуску оболонки

Додайте до ~/.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, щоб зробити це постійним.

​
Пов’язане