English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Install overview

Node.js

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

macOS

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

brew install node

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

Linux

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

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

Windows

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

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

openclaw: command not found

Це майже завжди означає, що глобальний bin-каталог npm не додано до вашого PATH.

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

    npm prefix -g

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

    echo "$PATH"

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

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

    macOS / Linux

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

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

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

    Windows

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

    Пов'язане