Установка OpenClaw: пошаговая инструкция для Windows, Mac, Linux и сервера

OpenClaw — опенсорс-платформа ИИ-агентов, которая ставится на свой сервер или компьютер и работает там, где вы сами решаете. Установка openclaw занимает 10–15 минут: проверяете систему, ставите пакет через npm, проходите мастер настройки — и агент выходит на связь. В инструкции разберём установку openclaw на windows, mac, linux и в docker, настройку openclaw, подключение моделей и каналов и типичные ошибки. Если в поиске вы писали «опен кло» или спрашивали, что такое openclaw ai — это он: движок, на котором собираются ии агент openclaw и целые корпоративные системы.

01. Что такое OpenClaw и зачем его устанавливать

OpenClaw — это бесплатный движок с открытым исходным кодом. Openclaw agent — это цифровой сотрудник, который умеет работать с вашими сервисами: читает почту, ведёт задачи, собирает отчёты, отвечает в мессенджерах. По сути openclaw нейросеть — это не отдельная модель, а движок, который умеет работать с любыми нейросетями. Ии агент openclaw работает локально: данные не уходят в чужой облачный сервис, а openclaw бесплатно закрывает те задачи, за которые у готовых SaaS берут подписку за каждое место. Openclaw assistant — так называют агента-помощника, собранного на этой платформе для конкретной роли: поддержка, продажи, документы.

Зачем ставить OpenClaw на свою машину или сервер:

• Конфиденциальность. Все данные в вашем контуре: документы, переписка и базы не попадают вендору.

• Гибкость. Подключаете любые модели и инструменты, а не то, что разрешила платформа.

• Экономия. Нет абонентской платы — платите только за токены моделей, которые используете.

• Автономность. Агент работает по расписанию, пока вы занимаетесь другими делами.

Выглядит сложно только на первый взгляд: как пользоваться openclaw, вы поймёте уже после первого запуска, а большую часть настройки берёт на себя мастер установки. Openclaw настроить под себя можно до деталей: модели, права, каналы, скиллы — всё описывается в конфиге. Если вам пригодится связка с конструкторами автоматизаций — openclaw n8n работает через общую шину: n8n оркестрирует сценарий, а OpenClaw исполняет агентные шаги с доступом к инструментам.

02. Что нужно для установки openclaw

Перед установкой проверьте систему. Официальные требования простые:

• Операционная система. macOS и Linux поддерживаются официально, openclaw windows — через WSL2 (так сильно рекомендуют разработчики). Работает и openclaw mac, и openclaw linux, и openclaw ubuntu.

• Node.js версии 22 или новее, Git и минимум 8 ГБ оперативной памяти.

• Для Linux могут понадобиться инструменты сборки: sudo apt install build-essential git python3.

• openclaw docker — вариант для тех, кто хочет изолированное окружение: образ собирается и запускается контейнером, обновления и зависимости не конфликтуют с системой.

Если у вас компактный мини-ПК вроде beelink openclaw-конфигураций — тоже подойдёт: OpenClaw нетребователен к железу, главное — оперативная память.

03. Установка openclaw через npm

Как установить openclaw — самый простой способ через npm, менеджер пакетов Node.js:

```bash

npm install -g openclaw@latest

```

Дальше варианты:

• Если выходит ошибка про Node.js — проверьте версию и управляйте ей через nvm.

• Если после установки команда «не найдена» (command not found) — добавьте глобальную папку npm в PATH.

• openclaw install из исходников: можно скачать openclaw github репозиторий и собрать вручную — так делают, когда нужна конкретная ветка или кастомная сборка. openclaw git — это тот же репозиторий, из которого ставится стабильная версия.

• Запрос «openclaw ai install» в поиске — это то же самое: установка движка OpenClaw через ту же команду.

Важно: в поиске встречаются openclaw com, openclaw ru и openclaw сайт — сайты-посредники. Исходники и релизы берите только с официального openclaw github и openclaw официальный сайт (это один и тот же проект), а не со сторонних загрузчиков. Официальный openclaw бесплатно доступен всем, никаких «покупок репо» не существует.

04. Первый запуск и мастер настройки

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

```bash

openclaw onboard --install-daemon

```

Команда openclaw run запускает процесс, а --install-daemon ставит openclaw как демон: он будет работать в фоне, и ваш gateway всегда готов. Мастер поможет настроить workspace, каналы, openclaw навыки и подключение моделей.

Полезные команды для первого запуска:

• openclaw start — запустить gateway.

• openclaw status — проверить, что всё работает.

• openclaw doctor — диагностика: сам проверит конфигурацию, зависимости и подключения.

• openclaw запустить / openclaw запуск — те же действия на русском, по сути это openclaw run.

Во время настройки вы увидите вопросы про gateway и workspace. Не пропускайте шаги: мастер страхует от ошибок. Если что-то «поехало» — проверьте файл openclaw.json: в нём вся конфигурация, и правится он вручную.

05. Проверка gateway и openclaw config

После мастера проверьте, что gateway работает:

```bash

openclaw gateway status

```

На macOS и Linux можно дополнительно посмотреть порт: lsof -i :18789 — вы должны увидеть привязку к 127.0.0.1:18789. Это значит, что gateway слушает локальный адрес, а не открыт в интернет.

Основные настройки:

• openclaw config — общий файл конфигурации; openclaw configure запускает настройку в интерактивном режиме.

• openclaw json — формат файла openclaw.json, в котором описаны модели, каналы и permission-правила.

• openclaw token — gateway-токен, он обязателен для всех клиентов и устройств, которые подключаются к gateway удалённо.

• openclaw providers — список провайдеров моделей, которые вы подключили; меняется через конфиг.

• openclaw команды — всё, что вы вводите в терминал; полный список даёт openclaw --help.

Правило безопасности: никогда не давайте gateway слушать 0.0.0.0 — так его видно из публичного интернета. Для удалённого доступа используйте SSH-туннель или обратный прокси с TLS (Nginx, Caddy).

06. Подключение моделей: openclaw api и провайдеры

OpenClaw не привязан к одной модели — это его главное отличие от закрытых платформ. Через openclaw api и настройку провайдеров подключается практически всё:

• Облачные модели: openclaw openai (GPT), claude openclaw (Anthropic), openclaw яндекс (YandexGPT), openclaw qwen, DeepSeek, GigaChat.

• Локальные модели: ollama openclaw — связка с Ollama, когда модель крутится на вашем железе; openclaw local — режим полностью локальной работы.

• Кодовые агенты: openclaw codex и openclaw opencode — инструменты для программирования; openclaw code / openclaw coding — сценарии, в которых агент пишет и правит код.

• Если вы выбирали между hermes vs openclaw или думали «openclaw или hermes» — оба ставятся одинаково через npm, но у OpenClaw больше каналов, скиллов и модель-провайдеров из коробки.

Для каждого провайдера нужен свой API-ключ — он указывается в openclaw config. openclaw token для gateway и ключи моделей — разные вещи: первый защищает ваш gateway, вторые — доступ к моделям.

07. Подключение каналов: openclaw telegram и другие

После установки openclaw подключить каналы — дело пары минут. Мастер сам предложит настроить их при первом запуске:

• openclaw telegram — агент отвечает в Telegram: личка, группы, бот.

• openclaw бот — связка с ботами в мессенджерах (WhatsApp, Slack, Discord и другие).

• Email, Google-календарь и CRM — через стандартные интеграции.

• В интерфейсе openclaw nodes видно все подключённые устройства и сессии, а openclaw интерфейс — это единая панель управления: команды, чаты, статусы.

Интерфейс доступен в нескольких видах: openclaw ui (веб-панель), openclaw app и openclaw desktop (настольное приложение), openclaw web — из браузера, openclaw android — с телефона. Что выбрать — дело вкуса: все они работают с одним gateway. openclaw os — так иногда называют сборку «Linux + OpenClaw», готовый образ для сервера.

08. Безопасность после установки

Настройка openclaw заканчивается безопасностью. Базовый набор:

• Включите sandbox — изолированное выполнение команд, чтобы агент не запускал процессы прямо на хосте.

• Требуйте подтверждение для действий уровня хоста и approve новых команд перед первым запуском.

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

• Используйте gateway token для каждого клиента и TLS для внешних соединений.

• Проверяйте скиллы перед установкой: вредоносный навык может украсть токены.

Известные уязвимости (например, CVE-2026-25253 — кража API-токенов через незащищённый gateway) закрываются обновлениями и изоляцией через Docker — поэтому не пропускайте апдейты и держите секреты вне конфига.

09. Частые ошибки и как их чинить

• Команда не найдена после установки — добавьте глобальную папку npm в PATH.

• Мастер падает на середине — проверьте интернет, перезапустите openclaw onboard --install-daemon; если ошибка осталась — смотрите openclaw.json, там битая или неполная конфигурация.

• Не открывается панель — проверьте SSH-туннель и что gateway запущен openclaw status).

• Gateway token error (1008) — пересоберите шаги подключения и проверьте токен.

• Не хватает памяти — закройте тяжёлые процессы или добавьте RAM; локальные модели требовательны к ОЗУ.

• Решили, что OpenClaw не нужен — как удалить openclaw: npm uninstall -g openclaw (вместе с папкой workspace по желанию).

Большинство проблем лечится перезапуском сервиса и чтением логов: openclaw doctor подскажет, что именно не так.

Нужен настроенный OpenClaw? Сделаем за вас

Установка openclaw — это 15 минут: проверка системы, npm install -g openclaw@latest, мастер настройки, подключение моделей и каналов. Дальше ии агент openclaw живёт на вашем сервере, работает по расписанию и не требует ежемесячной платы за место. Не хотите возиться с сервером сами? Именно это мы и делаем в Right Claw: разворачиваем и настраиваем OpenClaw под задачи компании — установка, gateway, модели, каналы и скиллы уже готовы, вы только подключаете свои сервисы. Первая неделя — бесплатно.