OpenClaw + OmniaKey: один провайдер, три семейства моделей

OpenClaw — это фреймворк, а не готовый ассистент: он даёт цикл агента, вызов инструментов и редактирование кода, но интеллект приходит от провайдера, который вы подключаете. Поэтому конфиг провайдера — самый важный файл, который вам предстоит править, а OmniaKey вписывается в него как один OpenAI-совместимый вход, который сразу даёт доступ к Claude, GPT и Gemini.

Добавьте OmniaKey как провайдера

Конфиг провайдеров лежит в ~/.openclaw/openclaw.json. Добавьте OmniaKey в models.providers:

{
  "models": {
    "mode": "merge",
    "providers": {
      "omniakey": {
        "baseUrl": "https://api.omniakey.com/v1",
        "apiKey": "your-omniakey-api-key",
        "api": "openai-completions",
        "models": [
          { "id": "claude-opus-4-8" },
          { "id": "gpt-5.5" },
          { "id": "gemini-3.1-pro-preview" }
        ]
      }
    }
  }
}

"mode": "merge" говорит OpenClaw добавить этот провайдер к вашему текущему конфигу, а не заменить его целиком — оставьте эту строку, если у вас уже определены провайдеры. Один OpenAI-совместимый провайдер покрывает три семейства моделей: OmniaKey маршрутизирует по id модели, поэтому claude-opus-4-8, gpt-5.5 и gemini-3.1-pro-preview идут через один вход.

Шаг, который все пропускают: добавьте модель в allowlist

Определить провайдера — это только половина дела. OpenClaw ещё требует, чтобы модель была в allowlist, иначе вы получите классическую ошибку model not allowed, даже когда ключ в порядке. Это идёт в тот же openclaw.json, рядом с блоком models — models и agents это соседние ключи верхнего уровня. Добавьте полное имя — provider/model-id — в agents.defaults:

{
  "agents": {
    "defaults": {
      "models": ["omniakey/claude-opus-4-8", "omniakey/gpt-5.5", "omniakey/gemini-3.1-pro-preview"],
      "model": "omniakey/claude-opus-4-8"
    }
  }
}

В теле запроса идёт только id модели; ref provider/model-id — это внутреннее имя OpenClaw. Нужны и определение провайдера, и запись в allowlist — они делают разную работу, и именно поэтому многие настраивают провайдера, забывают про allowlist и застревают.

Проверка

openclaw doctor

doctor проверяет файл конфига, провайдера, формат ключа, живое соединение и доступ к модели. Затем openclaw models list должен показать ваши модели OmniaKey, и вы сможете задать активную модель omniakey/gpt-5.5 — или любой id из allowlist — в agents.defaults.

Зачем пускать OpenClaw через OmniaKey

Один ключ и один баланс на все три семейства, оплата за токены без месячной подписки — и никакой молчаливой подмены. OmniaKey запускает ровно тот id модели, что в allowlist; если апстрим недоступен, вы видите ошибку, а не тихо подставленный «эквивалент», который посреди задачи иначе понимает вашу кодовую базу.

В руководстве по кодинг-агентам разобраны остальные инструменты.