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.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

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

    On this page