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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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

node -v
Якщо команда виводить v24.x.x або вище, ви використовуєте рекомендовану стандартну версію. Якщо вона виводить v22.16.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

Знайдіть свій глобальний префікс 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, щоб зробити це постійним.

​
Пов’язане