OpenClawDocs
На цій сторінці

На цій сторінці

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

Runtimes

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?