OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Install overview

Node.js

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

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

bash
node -v

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

Установіть Node

macOS

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

bash
brew install node

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

Linux

Ubuntu / Debian:

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

Fedora / RHEL:

bash
sudo dnf install nodejs

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

Windows

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

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey:

powershell
choco install nodejs-lts

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

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

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

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

Приклад із fnm:

bash
fnm install 24fnm use 24

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

openclaw: command not found

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

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

    bash
    npm prefix -g

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

    bash
    echo "$PATH"

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

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

    macOS / Linux

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

    bash
    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 на каталог, доступний користувачеві для запису:

    bash
    mkdir -p "$HOME/.npm-global"npm config set prefix "$HOME/.npm-global"export PATH="$HOME/.npm-global/bin:$PATH"

    Додайте рядок export PATH=... до ~/.bashrc або ~/.zshrc, щоб зберегти цю зміну назавжди.

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

    Was this useful?
    On this page

    On this page