OpenClaw: установка, настройка Gateway и подключение модели

OpenClaw это открытый Gateway для ИИ-агентов: вы запускаете его на своём компьютере или сервере, и он связывает чат-приложения вроде Telegram, WhatsApp и Slack с моделью и инструментами. Ставится одной командой, настраивается файлом ~/.openclaw/openclaw.json. Ниже установка, подключение модели через Claudexia, честный разговор о безопасности и сравнение с Hermes Agent.

Что такое OpenClaw и для чего он нужен

Документация OpenClaw описывает проект как самостоятельно размещаемый шлюз, который соединяет ваши чаты с ИИ-агентами. Gateway это один процесс: он ведёт сессии, маршрутизацию и подключения к каналам. Список каналов широкий: Discord, Google Chat, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo и веб-чат. Для настройки есть панель управления в браузере, по умолчанию на http://127.0.0.1:18789/.

Код лежит в репозитории openclaw/openclaw под лицензией MIT, у проекта около 393 тысяч звёзд. Развивает его OpenClaw Foundation, независимая некоммерческая организация. Сама модель в OpenClaw не живёт: для работы нужен ключ провайдера либо вход в уже установленный Claude Code или Codex CLI. Ключ Claudexia подходит как провайдер.

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

Установщик определяет систему, при необходимости ставит Node, ставит OpenClaw и запускает мастер настройки.

Требования к Node: 24.16.0 или новее в линейке 24.x, либо 26.1.0 и выше, рекомендуется Node 26. Исправления безопасности есть в 24.22.1 и 26.12.1, так что берите их. Команда curl | bash выполняет чужой скрипт. Если это неприемлемо, скачайте файл, прочитайте и запустите сами либо ставьте через npm.

Что делать после установки

Мастер openclaw onboard предлагает два режима. Quick start находит существующий доступ к ИИ, проверяет его реальным запросом, сохраняет конфиг и открывает панель. Custom setup проходит все варианты по шагам. Quick start держит Gateway в окне терминала, до нажатия Ctrl+C. Чтобы он работал фоном, выполните:

openclaw gateway install
openclaw gateway status
openclaw dashboard

Первая команда ставит службу (LaunchAgent на macOS, пользовательский юнит systemd на Linux и WSL2, задачу планировщика на Windows). Вторая показывает, что Gateway слушает порт 18789. Третья открывает панель управления, где можно написать первое сообщение. Если что-то не так, openclaw doctor покажет находки, а openclaw triage выполнит проверки только на чтение. На Windows документация считает самым простым путём приложение Windows Hub, но PowerShell-установщик и Gateway в WSL2 тоже поддерживаются.

Как подключить модель OpenClaw через Claudexia

Claudexia даёт OpenAI-совместимый адрес https://api.claudexia.tech/v1 и один ключ sk_cdx_... на все модели, оплата картой РФ, через СБП или криптой. Аккаунт у вендора и VPN не нужны. Конфиг из гайда Claudexia вставляется в ~/.openclaw/openclaw.json:

{
  "models": {
    "mode": "merge",
    "providers": {
      "claudexia": {
        "baseUrl": "https://api.claudexia.tech/v1",
        "apiKey": "sk_cdx_YOUR_KEY",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-6-astra", "name": "GPT-6 Astra", "contextWindow": 1000000, "maxTokens": 128000 },
          { "id": "claude-sonnet-5", "name": "Claude Sonnet 5", "contextWindow": 1000000, "maxTokens": 32000 }
        ]
      }
    }
  },
  "agents": { "defaults": { "model": { "primary": "claudexia/gpt-6-astra" } } }
}

Затем перезапустите службу и проверьте конфиг:

openclaw gateway restart
openclaw doctor

Поля читаются так. baseUrl и apiKey задают адрес и ключ. api выбирает протокол: openai-completions для OpenAI-совместимых серверов, по документации OpenClaw есть ещё anthropic-messages. В models каждая модель описана ID, названием, размером контекста и лимитом ответа, а в primary она пишется как провайдер, слэш и ID.

Три нюанса. Конфиг в формате JSON5, комментарии разрешены. Gateway принимает только файл, полностью совпадающий со схемой: лишний ключ или опечатка остановят запуск, а причину покажет openclaw doctor. Ключ не обязательно хранить в файле, OpenClaw умеет подставлять переменную окружения, например "apiKey": "${CLAUDEXIA_API_KEY}".

Прайс Claudexia на 29 октября 2026, актуальные цены на странице моделей. Агент гоняет длинный контекст много раз за сессию, и счёт растёт быстро: об этом отдельная статья «Счета за ИИ-агентов растут». Пока тестируете, держите на балансе небольшую сумму. Быстрый старт с ключом лежит в документации.

Безопасность: что может агент с доступом к системе

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

• Один Gateway рассчитан на одну границу доверия. По руководству по безопасности, OpenClaw не защищает от враждебных пользователей на общем агенте. Для смешанного круга людей поднимайте отдельные Gateway, ключи и лучше отдельных пользователей ОС или хосты.
• На обычной установке Gateway слушает только loopback. Неизвестным отправителям в личных сообщениях большинство каналов отвечает кодом сопряжения. Контейнерные образы исключение: они по умолчанию открыты наружу, их нужно закрывать авторизацией.
• Инструменты основной сессии выполняются на вашем хосте, пока вы не настроите песочницу. Входящие сообщения считайте недоверенными.
• Команда openclaw security audit проверяет конфигурацию на отклонения, а часть проверок поддерживает автоисправление.

Отдельная история с навыками из каталога ClawHub. Исследователи Koi Security проверили 2857 навыков и нашли 341 вредоносный, 335 из них из одной кампании ClawHavoc (новость от 2 февраля 2026). Навык просил выполнить команды в разделе «Prerequisites» и на macOS ставил вредонос Atomic Stealer. Практический вывод: ставьте навыки только после чтения их файлов, а агента запускайте на отдельной машине, виртуальной машине или под отдельным пользователем, где нет ваших ключей и рабочих документов. Что вообще нельзя отдавать моделям, перечислено в статье «Что нельзя отправлять в языковую модель».

OpenClaw и Ollama: локальные модели

Для локальных моделей OpenClaw ходит в родной API Ollama, а не в OpenAI-совместимый. Поэтому в baseUrl пишут корень сервера, например http://host:11434, без /v1: документация прямо предупреждает, что адрес с /v1 ломает вызов инструментов. Есть и вариант Ollama Cloud через провайдера ollama-cloud. Сколько вытянет ваше железо и насколько уверенно локальная модель вызывает инструменты, зависит от модели, так что проверяйте на своих задачах. Для сравнения с API держите под рукой ключ Claudexia и тот же агент: переключение занимает одну строку primary.

OpenClaw или Hermes Agent: что выбрать

Hermes Agent делает Nous Research. Страница сравнения лежит в документации самого OpenClaw, а не нейтральная, и это снимок на август 2026. Её данные:

Источник: сравнение в документации OpenClaw. Выбор упирается в то, как вы хотите ограничивать агента и где ему работать. Мы бы запустили оба на одной небольшой задаче с отдельным ключом и сравнили поведение и расход. Для Hermes в Claudexia тоже есть готовый конфиг, ~/.hermes/config.yaml:

model:
  provider: custom
  default: gpt-6-astra
  context_length: 1000000
  base_url: https://api.claudexia.tech/v1
  api_mode: chat_completions
  api_key: sk_cdx_YOUR_KEY

Для моделей Claude поставьте api_mode: anthropic_messages и модель Claude в default. Параметр context_length обязателен: без него Hermes считает контекст модели равным 128K. Если вам нужен агент именно для кода в терминале, а не для чатов, смотрите OpenCode, а выбор между шлюзами разбирает материал «Агрегатор нейросетей и API».

FAQ

Что такое OpenClaw?

Это открытый Gateway под лицензией MIT, который вы запускаете у себя и который связывает чаты (Telegram, WhatsApp, Slack и другие) с ИИ-агентом. Модель OpenClaw не содержит, ей нужен ключ провайдера или вход в Claude Code либо Codex CLI.

Как установить OpenClaw на Windows?

Документация называет рекомендуемым приложение Windows Hub. Запасные пути: установщик в PowerShell iwr -useb https://openclaw.ai/install.ps1 | iex или Gateway в WSL2. После установки выполните openclaw gateway install и openclaw gateway status.

Как подключить модель к OpenClaw?

Добавьте провайдера в блок models.providers файла ~/.openclaw/openclaw.json с адресом, ключом, протоколом и списком моделей, затем укажите agents.defaults.model.primary в виде провайдер/модель. Для Claudexia готовый конфиг приведён выше, после правки выполните openclaw gateway restart.

Что такое OpenClaw Gateway и как его перезапустить?

Gateway это один процесс, который ведёт сессии, маршрутизацию и подключения к чатам. Статус показывает openclaw gateway status, перезапуск делает openclaw gateway restart, диагностику openclaw doctor, панель открывает openclaw dashboard.

Безопасен ли OpenClaw?

Это зависит от настройки. По умолчанию Gateway слушает только loopback, а неизвестные отправители получают код сопряжения. Риск растёт, когда Gateway открывают наружу, отключают сопряжение или ставят чужие навыки без чтения. Запускайте агента отдельно от рабочих данных, а openclaw security audit покажет отклонения конфигурации.

OpenClaw или Hermes Agent: что выбрать?

Hermes Agent от Nous Research это платформа с CLI, шлюзом мессенджеров и плагинами, OpenClaw это Gateway для чатов и агентов с описанной моделью доверия. Проверьте оба на одной задаче: на выбор повлияют поведение агента и расход токенов, а не названия.

Работает ли OpenClaw с Ollama?

Да, через родной API Ollama. В baseUrl указывайте корень сервера без /v1, например http://host:11434, иначе вызов инструментов ломается.