OpenClaw: как установить на Windows, macOS, Linux

Установка OpenClaw начинается не с Docker и не с бесконечной настройки API ключей. Сначала нужно выбрать среду, в которой Gateway будет нормально работать.

Для обычного домашнего компьютера самый короткий путь проходит через официальный установщик. macOS и Linux используют shell скрипт, Windows может работать через нативный PowerShell или WSL2. Docker имеет смысл, когда нужен изолированный и постоянно работающий сервер.

На 22 сентября 2026 года для ручной установки рекомендуется актуальная ветка Node.js 26, минимум 26.1, либо поддерживаемая Node.js 24 LTS, минимум 24.16. Старые инструкции с Node 22.14+ уже нельзя считать надежным ориентиром.

Что выбрать для OpenClaw

Здесь легко усложнить себе жизнь без всякой причины.

Вариант	Когда использовать
Официальный установщик	Обычный ПК или Mac, первый запуск
Windows + WSL2	Нужна Linux среда внутри Windows
Docker Compose	VPS, сервер или изолированное окружение
npm/pnpm	Уже есть собственная Node.js инфраструктура

Для первого знакомства лучше взять обычную локальную установку. Сначала добейтесь ответа от модели через Gateway. Потом подключайте мессенджеры, инструменты и дополнительные интеграции.

Docker сам по себе не исправляет ошибки локальной установки. Он просто переносит проблему в контейнер, если причина вообще не связана с окружением.

Установка OpenClaw на macOS и Linux

Сначала проверьте Node.js:

node –version

Если Node уже установлен, убедитесь, что версия соответствует актуальным требованиям OpenClaw.

Затем запустите официальный установщик:

curl -fsSL https://openclaw.ai/install.sh | bash

Команда скачивает и запускает установочный скрипт. Если в вашей системе запрещено автоматически выполнять сторонние скрипты, сначала изучите содержимое установщика.

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

openclaw –version

Если onboarding еще не завершен, запустите:

openclaw onboard –install-daemon

Мастер настройки предложит выбрать провайдера модели, способ авторизации и параметры Gateway. Флаг –install-daemon также настраивает управляемый локальный сервис, чтобы OpenClaw мог запускаться автоматически.

После этого проверьте Gateway:

openclaw gateway status
openclaw doctor

И откройте интерфейс:

openclaw dashboard

Первый успешный запуск стоит проверять именно через реальный запрос модели. Рабочий Gateway еще не означает, что API ключ, модель и провайдер настроены правильно.

Windows: нативная установка или WSL2

Для обычной Windows можно использовать PowerShell:

iwr -useb https://openclaw.ai/install.ps1 | iex

После установки проверьте версию и запустите onboarding, если он не был выполнен автоматически:

openclaw –version
openclaw onboard –install-daemon

Если ваша работа завязана на Linux инструменты, WSL2 часто удобнее. В таком случае OpenClaw фактически устанавливается внутри Linux среды Windows.

Откройте PowerShell от имени администратора:

wsl –install

После перезагрузки завершите создание пользователя Ubuntu.

В терминале WSL проверьте Node:

node –version

Затем используйте тот же установщик, что и на Linux:

curl -fsSL https://openclaw.ai/install.sh | bash

После установки:

openclaw onboard –install-daemon
openclaw gateway status
openclaw doctor

Если Gateway работает, но браузер Windows не открывает Dashboard, проверьте порт, который сообщает openclaw dashboard, и сетевую связь между WSL2 и Windows. Не начинайте с изменения конфигурации OpenClaw наугад.

Docker: когда он действительно нужен

Docker удобен для VPS, серверов и постоянно работающего OpenClaw. Особенно если вы уже используете контейнеры и умеете обслуживать volumes, порты, секреты и обновления.

Но контейнеризация добавляет собственные точки отказа. Нужно следить за образом, persistent volumes, переменными окружения и доступом к Dashboard.

Для новой установки используйте официальную конфигурацию OpenClaw, а не случайный docker-compose.yml из старого гайда.

Официальный репозиторий можно получить так:

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

Далее используйте актуальный setup скрипт из проекта:

export OPENCLAW_IMAGE=”ghcr.io/openclaw/openclaw:latest”
./scripts/docker/setup.sh

Для серьезного сервера лучше зафиксировать проверенный тег или digest образа вместо слепого использования latest. Иначе следующий pull может изменить версию приложения без вашего участия.

Проверить контейнеры:

docker compose ps

Посмотреть последние сообщения Gateway:

docker compose logs –tail 50 openclaw-gateway

Не публикуйте Dashboard наружу без нормальной защиты. Открытый порт с интерфейсом управления на VPS быстро превращается из удобства в дыру.

Как понять, что OpenClaw действительно установлен

Три проверки закрывают большую часть проблем:

openclaw –version
openclaw gateway status
openclaw doctor

Затем:

openclaw dashboard

Отправьте короткий тестовый запрос выбранной модели.

Если Dashboard открывается, но модель молчит, проблема находится уже не в базовой установке. Проверяйте провайдера, API ключ, model ID и доступность модели.

Если Gateway вообще не запускается, смотрите конфигурацию и логи.

Это важное разделение. Иначе можно часами менять API ключ, когда на самом деле не работает локальный сервис.

Самые частые ошибки

EACCES permission denied

Проблема обычно связана с правами доступа к каталогу установки Node или npm.

Проверьте:

npm prefix -g

Не стоит автоматически запускать весь установщик через sudo или менять владельца системных каталогов рекурсивно. Лучше использовать пользовательский npm prefix или официальный локальный вариант установки.

После изменения PATH откройте новый терминал и проверьте:

which node
which openclaw

Так вы увидите, какие именно исполняемые файлы запускаются.

Порт 18789 уже занят

Проверьте процесс:

lsof -i :18789

Если это старый Gateway OpenClaw, завершите именно его процесс. Если порт занят другим нужным сервисом, настройте альтернативный порт согласно документации вашей версии OpenClaw.

Не убивайте процесс вслепую только потому, что команда нашла его.

429 Too Many Requests

Здесь проблема может быть в ограничении запросов провайдера или в исчерпанном лимите. Смотрите полный текст ошибки.

Повторять один и тот же запрос десятки раз бессмысленно, если аккаунт уже уперся в ограничение.

Dashboard работает, канал не работает

Если модель отвечает в Control UI, но сообщение не приходит в Telegram, WhatsApp или другой подключенный канал, Gateway уже прошел базовую проверку.

Проверяйте авторизацию самого канала, права аккаунта, pairing и логи доставки. У каждого интегрированного сервиса свои требования.

Например, WhatsApp в OpenClaw подключается через WhatsApp Web с QR кодом:

openclaw channels login –channel whatsapp

Не переносите настройки от одного канала к другому только потому, что названия переменных выглядят похоже.

API ключи: где чаще всего ломается конфигурация

OpenClaw может получать настройки из конфигурационного файла, переменных окружения, auth profiles и контейнерных secrets.

Главная проблема здесь простая: вы можете изменить один источник, а приложение продолжит читать другой.

API ключ нельзя проверять только по наличию переменной:

echo $GEMINI_API_KEY

Нужно убедиться, что именно процесс Gateway видит нужное значение.

Для Docker это особенно важно. Переменная, доступная в вашем терминале, не обязана автоматически появляться внутри контейнера.

Секреты не должны попадать в Git, публичные логи и скриншоты. Если используется .env, ограничьте права:

chmod 600 ~/.openclaw/.env

Для серверной установки лучше использовать механизм секретов или защищенное хранилище.

После установки не спешите подключать все подряд

Самая частая ошибка при первом запуске OpenClaw выглядит примерно так: пользователь одновременно подключает Claude, Gemini, WhatsApp, Telegram, MCP, tools, Docker и несколько агентов, после чего пытается понять, что именно сломалось.

Гораздо быстрее идти слоями:

Node.js → OpenClaw → Gateway → модель → Dashboard → один канал → дополнительные инструменты.

После каждого шага делайте короткий тест.

Такой подход работает и с другими AI агентами. Чем больше компонентов участвует в цепочке, тем бесполезнее становится диагностика по одному финальному сообщению об ошибке.

Обновление и резервная копия

Перед серьезным обновлением проверьте доступную версию:

openclaw update status
openclaw update –dry-run

Создайте проверенную резервную копию:

openclaw backup create –verify

Сам архив храните отдельно от компьютера или VPS. Если машина сломается, резервная копия на той же машине особой ценности не имеет.

После обновления снова проверьте:

openclaw gateway status
openclaw doctor

И отправьте тестовое сообщение.

Для Docker обновляйте образ через Compose и следите за persistent volumes. Не удаляйте volumes ради «чистой установки», пока не убедились, что в них нет нужной конфигурации и истории.

Что выбрать в итоге

Для обычного пользователя схема короткая: официальный установщик → onboarding → Gateway → Dashboard → тестовый ответ.

Windows можно использовать нативно. WSL2 нужен, когда удобнее работать в Linux окружении. Docker стоит выбирать для серверов, VPS и сценариев, где важны изоляция и воспроизводимость.

Самое полезное правило при установке OpenClaw звучит скучно, но экономит массу времени: добавляйте по одному компоненту и проверяйте его до следующего изменения.