Установка OpenClaw на рабочую машину: команды, время и что подготовить заранее

OpenClaw ставится одной командой, и это правда: на Windows, macOS и Linux установка занимает около десяти минут вместе с мастером первичной настройки. Сложности начинаются на шаге, который в инструкциях обычно пропускают, — когда агент просит доступ к модели, а российская карта на форме оплаты не проходит.

Мы прошли установку на трёх системах и собрали то, что важно на рабочей машине: какие права нужны, куда агент кладёт конфиг, что он получает вместе с доступом к вашим файлам и во сколько обходится первый месяц работы.

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

Нужны три вещи: Node.js 22.22.3 или новее, свободный порт для гейтвея и доступ к модели. Первое установщик берёт на себя.

Node.js официально поддерживается в версиях 26, а также 22.22.3, 24.15 и 25.9. Проверять вручную не обязательно: установочный скрипт сам смотрит, что стоит в системе, и при необходимости подтягивает нужную версию. Отдельно ставить pnpm нужно только тем, кто собирает агент из исходников.

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

Третье — деньги на модель. Агент без модели поставится и запустится, но отвечать не будет: своего «мозга» у него нет.

Десять минут — это реальный отрезок от команды до первого ответа, если доступ к модели готов заранее.

Промежуточный вывод: подготовка сводится к одному вопросу — есть ли у вас оплаченный доступ к модели. Всё остальное установщик решает сам.

Установка на Windows — одна строка в PowerShell, без WSL2 и без прав администратора в обычном случае.

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

WSL2 для установки не нужен. Смысл в нём появляется, только если у вас уже есть линуксовое окружение для разработки и вы хотите держать агент там же. Для знакомства с продуктом это лишний слой.

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

Отдельная деталь для корпоративной машины: если политика выполнения PowerShell закрыта, команда упрётся в запрет запуска скриптов. Это решается не флагом обхода политики, а обращением к системному администратору — самовольное снятие ограничения на рабочем ноутбуке обычно нарушает регламент.

На macOS, Ubuntu и в WSL2 команда одна и та же.

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

Если агент нужен не на ноутбуке, а на постоянно работающей машине — мини-ПК или VPS, — установка та же, но добавляются автозапуск, ограничение доступа к гейтвею и мониторинг. Это отдельный разговор, и мы разобрали его в материале про сервер.

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

npm подходит, если Node.js уже стоит в системе. Docker — если ставить Node в систему нельзя.

Через npm агент ставится как обычный глобальный пакет:

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

Docker имеет смысл в двух случаях: когда на машину нельзя ставить Node.js по регламенту и когда нужен headless-сервер без графического окружения.

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

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

Мастер `openclaw onboard` спрашивает рабочее пространство, канал связи и провайдера модели. Результат ложится в `~/.openclaw/openclaw.json`.

Кроме onboard есть ещё две команды: openclaw setup для первичной настройки гейтвея и openclaw configure для точечной правки готовой установки — например, сменить только модель, не проходя мастер заново.

Конфиг правится из терминала, открывать JSON руками не нужно:

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

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

👉 Оплатить подписку или баланс API в рублях

После установки состояние агента показывают `--version`, `doctor` и `gateway status`.

doctor — главная из трёх: она проверяет окружение целиком и показывает, чего не хватает, вместо общего «не работает». Типичные ответы на рабочей машине: не найден Node нужной версии, занят порт гейтвея, не задан провайдер модели.

Если агент установился, но молчит на любой запрос — почти всегда дело не в установке, а в доступе к модели: ключ не введён, баланс пуст или подписка не покрывает программное использование. Разбор конкретных ошибок с текстами сообщений мы вынесли в отдельный материал про диагностику.

Три команды закрывают вопрос «встало или нет» без чтения логов.

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

Сам агент бесплатен и открыт. Деньги уходят на модель — от $20 в месяц за подписку до оплаты по факту за токены.

Считать удобно по трём типовым сценариям. Цифры — на 14 августа 2026 года, курс 96 ₽ за доллар.

Первое пополнение имеет смысл делать небольшим — $10–20, чтобы понять реальный расход на своих задачах. Мы разложили расчёт по моделям и объёмам в отдельном материале про стоимость.

Две ошибки повторяются чаще всего: открытый наружу гейтвей и агент с полным доступом к рабочим каталогам.

Гейтвей по умолчанию слушает локально. Как только его выставляют в интернет — чтобы дотянуться с телефона или из дома, — он становится дверью к вашим файлам и подключённым каналам. Правильный путь описан в разделе безопасности документации: доступ ограничивается, а не открывается «на время».

Второе — рабочее пространство. Мастер спрашивает, с какими каталогами агент будет работать. На рабочей машине стоит указать конкретную папку проекта, а не домашнюю директорию целиком: агент читает и меняет файлы, к которым получил доступ, и разбирать последствия придётся вам.

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

Разница между рабочей установкой и инцидентом безопасности умещается в три строки настроек.

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

В обычном случае нет: скрипт работает правами вашего пользователя. Администратор понадобится, если корпоративная политика запрещает выполнение скриптов PowerShell или установку глобальных npm-пакетов.

Нет. Установщик проверяет версию и при необходимости ставит нужную сам. Поддерживаются Node.js 26, а также 22.22.3, 24.15 и 25.9.

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

Чаще всего не подключена модель или на балансе провайдера нет денег. Проверьте openclaw doctor и раздел провайдера в конфиге.

Около десяти минут вместе с мастером, если доступ к модели оплачен заранее. Если оплату приходится решать по ходу, время упирается в неё, а не в установку.