English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk 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

Це майже завжди означає, що глобальний bin-каталог 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 через Налаштування → Система → Змінні середовища.

    • Помилки дозволів під час 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