Установка OpenClaw на macOS и Linux: пошаговая инструкция

Перед установкой OpenClaw убедитесь, что ваша система соответствует минимальным требованиям. OpenClaw — это Node.js-приложение, поэтому основное требование связано с версией среды выполнения.

Обязательные требования: Node.js версии 24 (рекомендуется) или Node.js 22.16 и выше. npm версии 9 или новее (устанавливается вместе с Node.js). Операционная система: macOS 12 Monterey и выше, или любой современный дистрибутив Linux (Ubuntu 20.04+, Debian 11+, Fedora 36+, Arch Linux). Минимум 4 ГБ оперативной памяти (8 ГБ рекомендуется). Стабильное интернет-соединение (при использовании облачных LLM-провайдеров).

Рекомендуемые инструменты: git (для сборки из исходников), pnpm (для разработки), любой терминал с поддержкой UTF-8.

Откройте терминал и выполните команду для проверки установленной версии Node.js:

node --version

Если команда возвращает версию ниже 22.16, вам необходимо обновить Node.js. Рекомендуется использовать менеджер версий nvm (Node Version Manager) для управления версиями Node.js.

Если у вас ещё не установлен nvm, выполните следующую команду:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

После установки перезапустите терминал или выполните:

source ~/.bashrc

Для пользователей macOS с zsh вместо этого выполните:

source ~/.zshrc

Теперь установите рекомендуемую версию Node.js:

nvm install 24
nvm use 24

Проверьте, что установка прошла успешно:

node --version
npm --version

Самый простой способ установить OpenClaw — использовать пакетный менеджер npm. Выполните одну команду:

npm install -g openclaw@latest

Флаг -g устанавливает пакет глобально, что позволяет запускать команду openclaw из любой директории. Флаг @latest гарантирует установку самой свежей версии.

Если вы предпочитаете pnpm (более быстрый альтернативный менеджер пакетов), используйте:

pnpm install -g openclaw@latest

После установки проверьте, что OpenClaw доступен в системе:

openclaw --version

Команда должна вывести текущую версию пакета, например: openclaw v2026.3.11.

На macOS при глобальной установке через npm вы можете столкнуться с ошибкой доступа EACCES. Это связано с правами на директорию, куда npm устанавливает глобальные пакеты. Есть два решения.

Первое решение — использовать nvm, который устанавливает Node.js в домашнюю директорию пользователя и не требует sudo. Если вы установили Node.js через nvm (как описано выше), проблем с правами не будет.

Второе решение — изменить директорию глобальных пакетов npm:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

Добавьте последнюю строку в ваш файл ~/.zshrc или ~/.bash_profile, чтобы изменение сохранилось между сессиями.

На macOS также может потребоваться установка Xcode Command Line Tools, если они ещё не установлены:

xcode-select --install

На большинстве дистрибутивов Linux установка через npm проходит без проблем при использовании nvm. Если вы устанавливали Node.js через системный пакетный менеджер (apt, dnf, pacman), глобальная установка npm-пакетов может требовать sudo:

sudo npm install -g openclaw@latest

Однако использование sudo для npm install не рекомендуется из соображений безопасности. Лучше установите Node.js через nvm.

На некоторых дистрибутивах Linux может потребоваться установка дополнительных зависимостей для нативных модулей Node.js:

# Ubuntu / Debian
sudo apt update
sudo apt install build-essential python3

# Fedora
sudo dnf groupinstall 'Development Tools'
sudo dnf install python3

# Arch Linux
sudo pacman -S base-devel python

Если вы хотите работать с последней версией из ветки main, вносить изменения в код или участвовать в разработке, соберите OpenClaw из исходников.

Клонируйте репозиторий с GitHub:

git clone https://github.com/openclaw/openclaw.git
cd openclaw

Установите зависимости с помощью pnpm (OpenClaw использует pnpm в качестве менеджера пакетов для разработки):

npm install -g pnpm
pnpm install

Соберите проект:

pnpm run build

После успешной сборки вы можете запустить OpenClaw напрямую из директории проекта:

node dist/index.js --version

Для удобства использования создайте символическую ссылку:

pnpm link --global

Теперь команда openclaw будет доступна глобально и указывать на вашу локальную сборку.

После установки любым способом выполните серию проверочных команд:

openclaw --version
openclaw --help

Команда --version выводит текущую версию. Команда --help показывает список доступных подкоманд и флагов. Если обе команды отрабатывают без ошибок, установка прошла успешно.

Проблема: команда openclaw не найдена после установки. Убедитесь, что директория глобальных npm-пакетов добавлена в переменную PATH. Выполните npm config get prefix и проверьте, что путь bin внутри этой директории есть в вашем PATH.

Проблема: ошибка ENOENT при установке. Обычно вызвана отсутствием git или build-essential. Установите необходимые зависимости для вашей ОС (см. раздел про Linux выше).

Проблема: ошибка несовместимой версии Node.js. OpenClaw требует Node.js 22.16 или выше. Проверьте версию командой node --version и обновите при необходимости через nvm.

Проблема: медленная установка или таймауты. Попробуйте использовать альтернативный реестр npm или прокси. Также убедитесь, что ваше интернет-соединение стабильно. Для ускорения можно использовать pnpm вместо npm.

Для обновления OpenClaw до последней версии выполните ту же команду установки:

npm install -g openclaw@latest

Если вы собирали из исходников, обновите репозиторий и пересоберите:

cd openclaw
git pull origin main
pnpm install
pnpm run build

Рекомендуется следить за релизами на странице GitHub Releases, где публикуются заметки о новых версиях, исправлениях ошибок и критических обновлениях безопасности.

После успешной установки OpenClaw переходите к статье о первом запуске и начальной настройке, где мы подробно разберём процесс онбординга и конфигурации вашего AI-агента.