Node.js

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

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

node -v

Рекомендований стандартний варіант — v24.15.0 або новіша версія 24.x. v22.22.3 або новіша версія 22.x — підтримуваний варіант Node 22 LTS; Node v25.9.0+ також підтримується. Node 23 не підтримується. Якщо Node відсутній або його версія не належить до підтримуваного діапазону, виберіть нижче спосіб встановлення.

Установіть Node

macOS
Linux
Windows

Homebrew (рекомендовано):

brew install node

Або завантажте інсталятор для macOS із nodejs.org.

Ubuntu / Debian:

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

Fedora / RHEL:

sudo dnf install nodejs

Або скористайтеся менеджером версій (див. нижче).

winget (рекомендовано):

winget install OpenJS.NodeJS.LTS

Chocolatey:

choco install nodejs-lts

Або завантажте інсталятор для Windows із nodejs.org.

Використання менеджера версій (nvm, fnm, mise, asdf)

Менеджери версій дають змогу легко перемикатися між версіями Node. Популярні варіанти:

fnm — швидкий і кросплатформний
nvm — широко використовується в macOS/Linux
mise — багатомовний (Node, Python, Ruby тощо)

Приклад із fnm:

fnm install 24
fnm use 24

Ініціалізуйте менеджер версій у файлі запуску оболонки (~/.zshrc або ~/.bashrc). Якщо пропустити цей крок, у нових сеансах термінала команда openclaw може бути недоступною, оскільки PATH не міститиме каталогу виконуваних файлів Node.

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

`openclaw: command not found`

Це майже завжди означає, що каталог глобальних виконуваних файлів npm відсутній у PATH.

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

npm prefix -g

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

echo "$PATH"

Знайдіть у виведених даних <npm-prefix>/bin (macOS/Linux) або <npm-prefix> (Windows).

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

macOS / Linux
Windows

Додайте до ~/.zshrc або ~/.bashrc:

export PATH="$(npm prefix -g)/bin:$PATH"

Потім відкрийте новий термінал (або виконайте rehash у zsh / hash -r у bash).

Додайте результат виконання npm prefix -g до системного PATH через Settings → System → Environment Variables.

Помилки дозволів під час виконання `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, щоб зберегти цю зміну назавжди.

Пов’язані матеріали

Огляд встановлення — усі способи встановлення
Оновлення — підтримання OpenClaw в актуальному стані
Початок роботи — перші кроки після встановлення

Install overview

Maintenance

Containers

Hosting

Advanced setup

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

Установіть Node

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

`openclaw: command not found`

Помилки дозволів під час виконання `npm install -g` (Linux)

Пов’язані матеріали

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

​Установіть Node

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

​openclaw: command not found

​Помилки дозволів під час виконання npm install -g (Linux)

​Пов’язані матеріали

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

Установіть Node

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

`openclaw: command not found`

Помилки дозволів під час виконання `npm install -g` (Linux)

Пов’язані матеріали