Установка OpenClaw: Windows, macOS, Linux и Docker — с командами и первым запуском

OpenClaw ставится одной командой в терминале — минут за десять, если ничего не блокирует сеть. Дальше начинается вторая часть: на первом запуске агент спрашивает, к какой модели подключаться, и вот тут у многих затык. Сам OpenClaw бесплатный, а вот доступ к модели — платный, и российская карта на этом шаге не проходит. В статье — точная команда установки под каждую систему, что делать, если версия Node не подходит, как пройти онбординг и как проверить, что всё встало.

Для установки OpenClaw нужны Node.js 26 (или минимум 22.22.3, 24.15, 25.9), свободный порт для гейтвея и доступ к модели — без него агент запустится, но не сможет отвечать.

Установщик сам проверяет версию Node и при необходимости подтягивает нужную — вручную ставить Node заранее не обязательно. Отдельно устанавливать pnpm нужно только тем, кто собирает OpenClaw из исходников, рядовому пользователю он не понадобится.

Дальше агенту нужен доступ к модели — это отдельный платёж, который не проходит с российской карты напрямую.

👉 Оплатить доступ к модели в рублях, пока агент ещё ставится

На Windows OpenClaw ставится одной командой PowerShell, которая скачивает и запускает установочный скрипт с официального домена.

Скрипт определяет версию Windows, проверяет Node и при необходимости ставит нужную, после чего сам предлагает пройти онбординг. Если онбординг не нужен прямо сейчас, у скрипта есть отдельный флаг для запуска без него.

WSL2 для установки не обязателен — команда выше работает и в обычном PowerShell. Смысл ставить WSL2 появляется, если вы уже держите на машине линуксовое окружение для разработки и хотите, чтобы OpenClaw жил там же, а не в Windows напрямую. Для разового знакомства с агентом WSL2 — лишний шаг.

В выдаче по этой теме встречается вариант команды с irm вместо iwr -useb — он тоже рабочий, оба алиаса ведут на один и тот же командлет PowerShell. Но в официальной документации указан именно iwr -useb, и в блок кода имеет смысл ставить формулировку с сайта разработчика, а не пересказ из сторонней статьи.

Одна команда в PowerShell закрывает установку на Windows целиком — дальше остаётся только пройти онбординг.

На macOS, Linux и в WSL2 команда установки одна и та же — через curl.

Скрипт скачивает установщик, проверяет версию Node и запускает онбординг сразу после установки — точно так же, как на Windows. Для Ubuntu отдельных шагов нет: команда работает без изменений, разница только в том, что именно установщик подтянет для конкретного дистрибутива.

Если вы планируете держать OpenClaw на Mac mini как круглосуточного агента, а не только пробовать его на рабочей машине, разумнее сразу почитать отдельный материал про сервер и мини-ПК — там разбор ресурсов и автозапуска, здесь речь только про сам факт установки.

Путь от проверки Node.js до готового агента укладывается в 10 минут.

Тем, у кого Node.js уже стоит в системе, проще поставить OpenClaw как обычный npm-пакет.

Здесь есть неочевидная деталь: начиная с npm 12 lifecycle-скрипты пакетов по умолчанию заблокированы, и без флага --allow-scripts openclaw установка молча завершится без ошибки, но агент не заработает как надо — часть post-install шагов просто не выполнится. Это самая частая причина, почему npm-установка «вроде прошла», а команда openclaw дальше не запускается или запускается не полностью. Флаг --install-daemon у onboard сразу регистрирует OpenClaw как фоновую службу, чтобы не запускать его вручную при каждой перезагрузке.

Docker имеет смысл тем, кто не хочет ставить Node в основную систему, и тем, кому нужен headless-сервер без графического окружения — например, отдельная машина, которая крутит агента постоянно. Для разового знакомства с OpenClaw на личном ноутбуке это лишний слой: проще поставить агент напрямую через iwr или curl.

Официальный сценарий запускает сборку и онбординг через готовый скрипт, а затем поднимает гейтвей отдельной командой:

Точный docker-compose.yml и флаги для готового образа из реестра меняются вместе с релизами, поэтому конкретный набор переменных под ваш сценарий (локальный билд или готовый образ ghcr.io/openclaw/openclaw) лучше сверить в разделе `/install/docker` официальной документации перед запуском. Команды внутри уже поднятого контейнера выполняются глобальным флагом --container <имя>, без захода в него отдельным docker exec.

После установки любым из способов запускается мастер openclaw onboard — он задаёт вопросы про рабочее пространство, каналы связи и провайдера модели, а результат сохраняет в ~/.openclaw/openclaw.json. Отдельно есть openclaw setup для первичной настройки гейтвея и здоровья системы и openclaw configure, который правит уже готовую установку точечно — например, только модель или только канал, без повторного прохождения всего мастера.

Конфиг можно смотреть и менять напрямую, не открывая openclaw.json руками:

Модель задаётся в формате provider/model — например anthropic/claude-opus-4-6. Веб-интерфейс для тех, кто не хочет жить в терминале, поднимается командой openclaw dashboard.

Именно на шаге выбора провайдера в мастере агент просит ключ API или подписку — и здесь начинаются деньги. Российская карта на этом шаге не проходит. Мы в «Оплата Забугор» оплачиваем доступ к моделям в рублях: переводите сумму привычным способом, мы платим за вас зарубежной картой. Курс на 13 августа 2026 года — доллар 96 ₽, евро 114 ₽, комиссия считается лесенкой от суммы платежа: до 999 ₽ — фиксированные 350 ₽, 1 000–2 999 ₽ — 32%, 3 000–4 999 ₽ — 27%, 5 000–9 999 ₽ — 22%, дальше ставка снижается и на суммах от 100 000 ₽ опускается до 7%. Если хочется платить самостоятельно — можно получить предоплаченную карту и ввести её реквизиты прямо в форму провайдера.

👉 Получить предоплаченную карту и ввести её реквизиты самому

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

--version просто подтверждает, что бинарник на месте и виден системе. doctor прогоняет диагностику окружения — версию Node, права на нужные папки, доступность порта — и в норме заканчивается коротким списком без красных пунктов. gateway status показывает, поднят ли сам процесс гейтвея и слушает ли он порт. Если doctor ругается на что-то из списка — это отдельная тема с типовыми ошибками OpenClaw, разбор которой не помещается в статью про установку.

Приложения OpenClaw для iOS и Android — это не установка агента на телефон, а клиент, который подключается к уже работающему гейтвею на компьютере или сервере. Сам агент как считал, обрабатывал запросы и хранил рабочее пространство на своей машине, так и продолжает это делать — телефон только показывает переписку, голосовой ввод и запросы на подтверждение действий.

Практически это значит: сначала OpenClaw ставится одним из способов выше на компьютер или сервер, и только потом телефон подключается к нему как второе устройство. Без работающего где-то гейтвея мобильное приложение само по себе агента не запустит.

Рекомендована Node.js 26. Из более старых веток поддерживаются 22.22.3 и новее, 24.15 и новее, 25.9 и новее. Node 23 не поддерживается. Установочный скрипт сам проверяет версию и при необходимости подтягивает нужную.

iwr -useb ... | iex и аналогичный curl ... | bash для Unix — это официальные установочные скрипты, которые сами ставят Node при необходимости и запускают онбординг. Установка через npm install -g openclaw@latest рассчитана на тех, у кого Node уже стоит в системе, и требует отдельного флага --allow-scripts openclaw начиная с npm 12.

Нет, для самой установки WSL2 не обязателен — команда iwr -useb https://openclaw.ai/install.ps1 | iex работает в обычном PowerShell. WSL2 имеет смысл, если вы уже держите на машине линуксовое окружение для разработки и хотите разместить агента там же.

В файле ~/.openclaw/openclaw.json. Менять его можно вручную или через команды openclaw config get, set, unset, file и validate, не открывая файл напрямую.

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

Само приложение для Android ставится бесплатно, но это клиент, а не полноценная установка агента. Чтобы им пользоваться, OpenClaw сначала нужно поставить на компьютер или сервер и запустить гейтвей — телефон подключается к нему как второе устройство.

Если коротко: проверьте версию Node, выполните установщик под вашу систему, пройдите openclaw onboard, подключите модель и прогоните openclaw doctor — на этом установка закрыта. Единственный платный шаг во всей цепочке — доступ к модели, и именно на нём чаще всего встаёт российская карта.

Список сервисов на сайте «Оплата Забугор» не закрытый. Если нужного провайдера или плана в нём пока нет — это не препятствие: напишите, что именно нужно оплатить, и мы посчитаем стоимость и оплатим.

👉 Не нашли нужный сервис? Оплатим и его