OpenClawDocs
На этой странице

На этой странице

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Runtimes

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?