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

Это почти всегда означает, что глобальный каталог 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