Перейти до основного вмісту

​
Node.js

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

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

node -v
Якщо команда виводить v24.x.x або вище, у вас рекомендований типовий варіант. Якщо вона виводить v22.14.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
Переконайтеся, що ваш менеджер версій ініціалізується у файлі запуску shell (~/.zshrc або ~/.bashrc). Інакше openclaw може не знаходитися в нових сесіях термінала, оскільки PATH не міститиме bin-каталог Node.

​
Усунення несправностей

​
openclaw: command not found

Майже завжди це означає, що глобальний bin-каталог npm відсутній у вашому PATH.
1

Знайдіть глобальний npm prefix

npm prefix -g
2

Перевірте, чи є він у PATH

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

Додайте його до файлу запуску shell

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

​
Помилки прав доступу під час 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, щоб зробити зміну постійною.

​
Пов’язане