ModelGate в OpenClaw
Этот сценарий подходит, если вы хотите использовать ModelGate через OpenClaw как терминальный OpenAI-совместимый клиент без отдельного GUI.
Установите OpenClaw и API-ключ
Установите OpenClaw, затем создайте ключ в разделе API-ключи. Если аккаунта ещё нет, сначала пройдите быстрый старт.
Укажите OpenAI-совместимые параметры подключения
Для подключения OpenClaw к ModelGate нужно указать OpenAI-совместимого провайдера, base URL, API-ключ и модель. Это можно сделать либо напрямую в конфиге, либо через onboarding.
https://api.modelgate.ru/v1 или https://secure.api.modelgate.ru/v1API 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
Проверьте первый запрос из терминала
Запустите OpenClaw с вашей конфигурацией и попросите его выполнить простую задачу: объяснить файл, предложить рефакторинг или составить план изменений. Если ключ, идентификатор модели и base URL заданы корректно, запрос уйдёт в ModelGate как обычный OpenAI-совместимый chat completion.
Практические советы
| Сценарий | Что сделать |
|---|---|
| Модель не находится | Проверьте, что в ключе разрешены нужные уровни доверия и укажите корректный model id из каталога. |
| Нужны задачи с персональными данными | Переключите base URL на https://secure.api.modelgate.ru/v1 и настройте fallback-модель для безопасного роутера. |