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

Node.js

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

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

node -v

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

Установка Node

brew install node

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

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

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 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, чтобы сделать её постоянной.

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