Node.js

OpenClaw требует Node 22.22.3+, Node 24.15+ или Node 25.9+. Node 24 — среда выполнения по умолчанию и рекомендуемая среда для установки, CI и процессов выпуска; Node 22 по-прежнему поддерживается в рамках активной ветки LTS. Node 23 не поддерживается. Скрипт установки автоматически обнаруживает и устанавливает Node — используйте эту страницу, если хотите настроить Node самостоятельно (версии, PATH, глобальные установки).

Проверка версии

node -v

v24.15.0 или более новая версия 24.x рекомендуется по умолчанию. v22.22.3 или более новая версия 22.x поддерживается в рамках ветки Node 22 LTS; Node v25.9.0+ также поддерживается. Node 23 не поддерживается. Если Node отсутствует или его версия находится вне поддерживаемого диапазона, выберите один из способов установки ниже.

Установка Node

macOS
Linux
Windows

Homebrew (рекомендуется):

brew install node

Или скачайте установщик для macOS с сайта nodejs.org.

Ubuntu / Debian:

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

Fedora / RHEL:

sudo dnf install nodejs

Или используйте менеджер версий (см. ниже).

winget (рекомендуется):

winget install OpenJS.NodeJS.LTS

Chocolatey:

choco install nodejs-lts

Или скачайте установщик для Windows с сайта nodejs.org.

Использование менеджера версий (nvm, fnm, mise, asdf)

Менеджеры версий позволяют легко переключаться между версиями Node. Популярные варианты:

fnm — быстрый, кроссплатформенный
nvm — широко используется в macOS/Linux
mise — поддерживает несколько языков (Node, Python, Ruby и т. д.)

Пример с fnm:

fnm install 24
fnm use 24

Инициализируйте менеджер версий в файле запуска командной оболочки (~/.zshrc или ~/.bashrc). Если пропустить этот шаг, команда openclaw может быть недоступна в новых сеансах терминала, поскольку PATH не будет содержать каталог bin Node.

Устранение неполадок

`openclaw: command not found`

Это почти всегда означает, что глобальный каталог bin npm отсутствует в PATH.

Определите глобальный префикс npm

npm prefix -g

Проверьте, присутствует ли он в PATH

echo "$PATH"

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

Добавьте его в файл запуска командной оболочки

macOS / Linux
Windows

Добавьте в ~/.zshrc или ~/.bashrc:

export PATH="$(npm prefix -g)/bin:$PATH"

Затем откройте новый терминал (или выполните rehash в zsh / hash -r в bash).

Добавьте вывод npm prefix -g в системную переменную PATH через Settings → System → Environment Variables.

Ошибки прав доступа при `npm install -g` (Linux)

Если возникают ошибки EACCES, измените глобальный префикс npm на каталог, доступный пользователю для записи:

mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"

Добавьте строку export PATH=... в ~/.bashrc или ~/.zshrc, чтобы сохранить настройку.

См. также

Обзор установки — все способы установки
Обновление — поддержание OpenClaw в актуальном состоянии
Начало работы — первые шаги после установки

Install overview

Maintenance

Containers

Hosting

Advanced setup

Проверка версии

Установка Node

Устранение неполадок

`openclaw: command not found`

Ошибки прав доступа при `npm install -g` (Linux)

См. также

​Проверка версии

​Установка Node

​Устранение неполадок

​openclaw: command not found

​Ошибки прав доступа при npm install -g (Linux)

​См. также

Проверка версии

Установка Node

Устранение неполадок

`openclaw: command not found`

Ошибки прав доступа при `npm install -g` (Linux)

См. также