GonkaGate Настройка custom provider в OpenClaw

Используйте этот гайд, когда вы уже работаете с OpenClaw и хотите подключить GonkaGate как custom OpenAI-compatible provider. Здесь только короткий рабочий путь, форма provider плюс allowlist, которую ожидает OpenClaw, и проверки, подтверждающие, что запросы действительно уходят в GonkaGate.

Если вы попали сюда из широкого маршрута guides или integrations и вам сначала нужно выбрать правильную owner-страницу, используйте гайды по wrapper-интеграциям и инструментам для выбора wrapper path или OpenAI SDK Compatibility для общих правил по base URL, auth и request shape.

Быстрый путь

Используйте этот путь, если стандартный onboarding OpenClaw вам подходит. Нужны установленный OpenClaw, API-ключ GonkaGate и model ID из Get models.

Interactive onboarding

openclaw onboard

Non-interactive onboarding

openclaw onboard --non-interactive \
  --auth-choice custom-api-key \
  --custom-base-url "https://api.gonkagate.com/v1" \
  --custom-model-id "qwen/qwen3-235b-a22b-instruct-2507-fp8" \
  --custom-api-key "$GONKAGATE_API_KEY" \
  --custom-compatibility openai

Если в вашей версии OpenClaw используются другие флаги, сверяйтесь со справкой по команде openclaw onboard.

Проверка после onboarding

openclaw models list
openclaw models status

Пример

/models
/model qwen3-235b
/status

Убедитесь, что:

В /models появился qwen3-235b.
Команда /model qwen3-235b переключает активную модель.
Тестовый промпт возвращает валидный ответ через GonkaGate.

Как должен выглядеть manual config

Если нужно проверить или отредактировать JSON вручную, в конфиге OpenClaw должны быть четыре вещи:

GONKAGATE_API_KEY в env-блоке или в другом источнике секретов, который умеет читать OpenClaw.
Запись provider в models.providers.gonkagate.
Точный GonkaGate model ID внутри списка provider models[].
Fully-qualified allowlist key в agents.defaults.models.

Конфиг provider обычно находится в ~/.openclaw/openclaw.json. В старых установках может использоваться ~/.clawdbot/clawdbot.json, обычно как symlink.

Как должен выглядеть manual config

{
  "env": {
    "GONKAGATE_API_KEY": "gp-..."
  },
  "models": {
    "mode": "merge",
    "providers": {
      "gonkagate": {
        "baseUrl": "https://api.gonkagate.com/v1",
        "apiKey": "${GONKAGATE_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen/qwen3-235b-a22b-instruct-2507-fp8",
            "name": "qwen/qwen3-235b-a22b-instruct-2507-fp8",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 262144,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "models": {
        "gonkagate/qwen/qwen3-235b-a22b-instruct-2507-fp8": {
          "alias": "qwen3-235b"
        }
      },
      "model": {
        "primary": "gonkagate/qwen/qwen3-235b-a22b-instruct-2507-fp8"
      }
    }
  }
}

Держите границы между этими полями явными:

api должен быть openai-completions, чтобы OpenClaw отправлял запросы в OpenAI-compatible путь /chat/completions.
baseUrl должен быть https://api.gonkagate.com/v1.
id у provider должен совпадать с точным GonkaGate model ID.
Короткий alias живёт только в agents.defaults.models, а не в provider id.

Применение и проверка

После правки примените конфиг, чтобы OpenClaw перечитал provider и allowlist.

Применение и проверка

openclaw gateway config.apply --file ~/.openclaw/openclaw.json

Если в вашей сборке config.apply ещё не поддерживается, перезапустите gateway:

Команда

openclaw gateway restart

Дальше прогоните и CLI-, и chat-проверки:

openclaw models list, чтобы убедиться, что metadata провайдера загрузилась.
openclaw models status, чтобы убедиться, что gateway видит provider.
/models, чтобы проверить, что alias доступен.
/model qwen3-235b и /status, чтобы убедиться, что выбранная модель поменялась.
Один тестовый промпт, чтобы подтвердить полный request path через GonkaGate.

Частые проблемы

`model not allowed`

Запись в allowlist отсутствует или записана неверно.

Используйте fully-qualified key gonkagate/qwen/qwen3-235b-a22b-instruct-2507-fp8.
Храните qwen3-235b только как alias.
После правки JSON заново примените конфиг.

Модель не появляется в `/models`

Обычно отсутствует одна из двух частей: metadata провайдера или allowlist entry.

Проверьте, что в models.providers.gonkagate.models[] есть нужный model ID.
Проверьте, что в agents.defaults.models есть matching fully-qualified key.
Снова примените конфиг и повторите /models.

Вызывается не та модель

OpenClaw может переслать только тот model ID, который указан у вас в provider-конфиге.

Установите id строго в qwen/qwen3-235b-a22b-instruct-2507-fp8.
Не сокращайте и не переименовывайте этот ID в provider block.
Используйте alias только в allowlist entry.

Ошибки auth или base URL

Сначала проверьте общие connection values, а уже потом продолжайте отладку внутренностей OpenClaw.

Убедитесь, что base URL равен https://api.gonkagate.com/v1.
Убедитесь, что API-ключ начинается с gp-.
Проверьте JSON на синтаксические ошибки перед повторным apply.

Связанные страницы

Get models для актуальных machine-readable model ID перед правкой provider-конфига.
Аутентификация и API-ключи для создания ключей, формата заголовка и ротации.
Обзор справочника API для точного request/response контракта после того, как OpenClaw пересылает вызов.
Обработка ошибок API для request ID, retry-решений и escalation flow после того, как provider path заработал.

Настройка custom provider в OpenClaw

On this page