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

OpenClaw это открытый Gateway для ИИ-агентов. Вы запускаете его на своём компьютере или сервере, и он соединяет чат-приложения (Telegram, WhatsApp, Slack) с моделью и набором инструментов. Установка занимает одну команду, а вся настройка живёт в файле ~/.openclaw/openclaw.json. Дальше: установка, подключение модели через codexkey, риски для системы и сравнение с 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. Ключ codexkey в роли провайдера подходит.

Установка 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 через codexkey

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

{
  "models": {
    "mode": "merge",
    "providers": {
      "codexkey": {
        "baseUrl": "https://api.codexkey.ru/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": "codexkey/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": "${CODEXKEY_API_KEY}".

Цены взяты из прайса codexkey на 29 октября 2026, актуальные смотрите на странице моделей. За сессию агент много раз гоняет длинный контекст, и счёт растёт быстро: об этом отдельная статья про счета за ИИ-агентов. На время тестов держите на балансе небольшую сумму. Быстрый старт с ключом описан в документации.

Безопасность OpenClaw: чем рискует система, к которой у агента есть доступ

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

• 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 нужен корень сервера без /v1, например http://host:11434: адрес с /v1, как прямо предупреждает документация, ломает вызов инструментов. Доступен и Ollama Cloud через провайдера ollama-cloud. Сколько вытянет ваше железо и насколько уверенно локальная модель вызывает инструменты, зависит от самой модели, так что проверяйте на своих задачах. Для сравнения с API держите под рукой ключ codexkey и того же агента: переключение занимает одну строку primary.

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

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

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

model:
  provider: custom
  default: gpt-6-astra
  context_length: 1000000
  base_url: https://api.codexkey.ru/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 в виде провайдер/модель. Готовый конфиг для codexkey приведён выше, после правки выполните 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): с /v1 вызов инструментов перестаёт работать.