ModelGate в OpenClaw

Этот сценарий подходит, если вы хотите использовать ModelGate через OpenClaw как терминальный OpenAI-совместимый клиент без отдельного GUI.

1

Установите OpenClaw и API-ключ

Установите OpenClaw, затем создайте ключ в разделе API-ключи. Если аккаунта ещё нет, сначала пройдите быстрый старт.

2

Укажите OpenAI-совместимые параметры подключения

Для подключения OpenClaw к ModelGate нужно указать OpenAI-совместимого провайдера, base URL, API-ключ и модель. Это можно сделать либо напрямую в конфиге, либо через onboarding.

Base URL: https://api.modelgate.ru/v1 или https://secure.api.modelgate.ru/v1
API Key: rp_ваш_api_ключ
Model: deepseek-v3.2, gpt-5-mini или другая модель из каталога

2.1 Через конфиг

Если вы уже знаете, где OpenClaw хранит конфигурацию в вашей системе, самый прямой вариант — сразу прописать подключение к ModelGate в конфиге. На Linux конфиг обычно находится по пути ~/.openclaw/openclaw.json.

Ниже минимальный шаблон в формате OpenClaw JSON: он задаёт провайдера ModelGate, ваш API-ключ и модель по умолчанию. Остальные секции можно оставить как есть в вашем текущем конфиге.

{
    "agents": {
        "defaults": {
            "model": {
                "primary": "custom-api-modelgate-ru/minimax-m2.7"
            },
            "models": {
                "custom-api-modelgate-ru/minimax-m2.7": {}
            }
        }
    },
    "models": {
        "mode": "merge",
        "providers": {
            "custom-api-modelgate-ru": {
                "baseUrl": "https://api.modelgate.ru/v1",
                "api": "openai-completions",
                "apiKey": "rp_ваш_api_ключ",
                "models": [
                    {
                        "id": "minimax-m2.7",
                        "name": "minimax-m2.7 (ModelGate)"
                    }
                ]
            }
        }
    }
}

2.2 Через onboarding

Можно пройти онбординг одной командой ниже.

Важно: неинтерактивная настройка требует явного подтверждения риска. В OpenClaw это соответствует флагу --accept-risk. Пользуясь командой ниже, вы тем самым подтверждаете принятие этого риска. Перед использованием стоит прочитать раздел безопасности OpenClaw: docs.openclaw.ai/security.

openclaw onboard --non-interactive \
  --auth-choice custom-api-key \
  --custom-base-url "https://api.modelgate.ru/v1" \
  --custom-model-id "minimax-m2.7" \
  --custom-api-key "rp_ваш_api_ключ" \
  --custom-compatibility openai \
  --accept-risk
3

Проверьте первый запрос из терминала

Запустите OpenClaw с вашей конфигурацией и попросите его выполнить простую задачу: объяснить файл, предложить рефакторинг или составить план изменений. Если ключ, идентификатор модели и base URL заданы корректно, запрос уйдёт в ModelGate как обычный OpenAI-совместимый chat completion.

Практические советы

Сценарий Что сделать
Модель не находится Проверьте, что в ключе разрешены нужные уровни доверия и укажите корректный model id из каталога.
Нужны задачи с персональными данными Переключите base URL на https://secure.api.modelgate.ru/v1 и настройте fallback-модель для безопасного роутера.