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

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

bash
node -v

Якщо команда виводить v24.x.x або вище, ви використовуєте рекомендовану стандартну версію. Якщо вона виводить v22.16.x або вище, ви використовуєте підтримуваний шлях Node 22 LTS, але ми все одно рекомендуємо перейти на Node 24, коли буде зручно. Якщо 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 через 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?