English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaishiالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiruفارسیไทย
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 24 — среда выполнения по умолчанию и рекомендуемая среда для установок, CI и рабочих процессов выпуска. Node 22 остается поддерживаемым через активную ветку LTS. Скрипт установки автоматически обнаружит и установит Node — эта страница предназначена для случаев, когда вы хотите настроить Node самостоятельно и убедиться, что все подключено правильно (версии, PATH, глобальные установки).

Проверьте свою версию

bash
node -v

Если команда выводит v24.x.x или выше, вы используете рекомендуемую версию по умолчанию. Если она выводит v22.19.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.

Using a version manager (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.

  • Find your global npm prefix

    bash
    npm prefix -g

  • Check if it's on your PATH

    bash
    echo "$PATH"

    Найдите в выводе <npm-prefix>/bin (macOS/Linux) или <npm-prefix> (Windows).

  • Add it to your shell startup file

    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