Среда выполнения Node

Node.js

OpenClaw требует Node 22 или новее. Скрипт установки автоматически обнаружит и установит Node — эта страница предназначена для случаев, когда вы хотите настроить Node самостоятельно и убедиться, что всё подключено правильно (версии, PATH, глобальные установки).

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

node -v

Если команда выводит v22.x.x или выше, всё в порядке. Если Node не установлен или версия слишком старая, выберите метод установки ниже.

Установка Node

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

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

Пример с fnm:

fnm install 22
fnm use 22

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

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

openclaw: команда не найдена

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

Шаг 1: Найдите глобальный префикс npm

npm prefix -g

Шаг 2: Проверьте, находится ли он в вашем PATH

echo "$PATH"

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

Шаг 3: Добавьте его в файл запуска оболочки

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

Добавьте вывод команды npm prefix -g в системный PATH через Параметры → Система → Переменные среды.

Ошибки прав доступа при 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, чтобы сделать её постоянной.

Флаги диагностикиПодробное руководство по управлению сессиями