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.19+, Node 23.11+ або Node 24+. Node 24 є стандартним і рекомендованим середовищем виконання для встановлення, CI та процесів випуску; Node 22 і надалі підтримується в межах активної гілки LTS. Сценарій встановлення автоматично виявляє та встановлює Node — скористайтеся цією сторінкою, якщо хочете налаштувати Node самостійно (версії, PATH, глобальні встановлення).

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

bash
node -v

Рекомендована стандартна версія — v24.x.x або новіша. v22.19.x або новіша — підтримуваний варіант Node 22 LTS (за нагоди оновіться до Node 24). Збірки Node 23 до v23.11.0 не підтримуються. Якщо 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