Настройка API ИИ-ассистента сводится к нескольким конкретным решениям: конечной точке провайдера, API-ключу, идентификаторам моделей, которые ассистент может вызывать, и плану на случай недоступности предпочтительной модели. Официальная документация по интеграции объединяет эти параметры в одной конфигурации провайдера.
Данное руководство соответствует действующей официальной документации. Она не предполагает, что одна модель или конфигурация подходит для всех рабочих нагрузок. Перед настройкой значений по умолчанию для рабочей среды ознакомьтесь с каталогом моделей.
Подготовьте ассистента перед добавлением провайдера
Установите помощника и сначала завершите процесс регистрации. В официальном руководстве по интеграции используются следующие команды:
npm install -g openclaw@latest
openclaw --version
openclaw onboard --install-daemonПеред добавлением поставщика услуг создайте ключ API. Считайте ключ секретом. Храните файл конфигурации в закрытом доступе и не отправляйте настоящий ключ в Git.
Добавить поставщика-помощника
Откройте файл конфигурации помощника и добавьте запись odirouter в models.providers. Приведённая ниже структура соответствует официальному руководству по интеграции. Замените заполнитель своим ключом и укажите только те модели, которые ассистент должен использовать.
{
"models": {
"providers": {
"odirouter": {
"api": "openai-completions",
"baseUrl": "https://api.odirouter.ai/v1",
"apiKey": "YOUR_API_KEY",
"models": [
{
"id": "gpt-5.6-sol",
"name": "GPT-5.6 SOL"
},
{
"id": "claude-sonnet-5",
"name": "Claude Sonnet 5"
}
]
}
}
}
}В некоторых установках также используется отдельный файл конфигурации моделей. Поддерживайте идентификатор провайдера, базовый URL, API-ключ и список моделей синхронизированными и в нём. В официальном руководстве также указано, что фрагменты конфигурации следует объединять в один файл конфигурации, а не заменять один фрагмент другим.
Задайте модель по умолчанию и резервный вариант
Конфигурация задаёт модель провайдера с provider-id/model-id. После объявления моделей в списке провайдера задайте основную модель и, если это подходит для рабочей нагрузки, резервную. Оба идентификатора должны оставаться в массиве models поставщика услуг.
{
"agents": {
"defaults": {
"model": {
"primary": "odirouter/gpt-5.6-sol",
"fallbacks": ["odirouter/claude-sonnet-5"]
},
"models": {
"odirouter/gpt-5.6-sol": {},
"odirouter/claude-sonnet-5": {}
}
}
}
}Резервный вариант — это оперативное решение, а не гарантия того, что две модели будут работать одинаково. Прежде чем полагаться на резервный вариант в рабочей среде, протестируйте задачи, задержку, стоимость и требования к результатам, важные для вашего ассистента.
Перезапустите и проверьте конфигурацию
После изменения конфигурации перезапустите шлюз. Затем проверьте активную модель и отправьте небольшое тестовое сообщение:
openclaw gateway restart
openclaw models status --plain
openclaw agent --agent main -m "hi" --jsonЕсли ассистент сообщает, что для провайдера нет API-ключа, проверьте models.providers.odirouter.apiKey и поищите другой файл, который переопределяет тот же идентификатор провайдера. Если модель не работает, проверьте её точный идентификатор и убедитесь, что она указана в обоих обязательных списках моделей.
Используйте официальную документацию
Для получения полной информации о настройке и устранении неполадок ознакомьтесь с документом official integration guide. Начните с official introduction, если вам всё ещё нужны API-ключ или вводная информация. Затем ознакомьтесь с available models, прежде чем завершать настройку ассистента.