Если агенту OpenClaw требуется другая модель, выбор проходит в три шага: авторизация у провайдера, значение primary в формате provider/model и проверка вызова инструментов на эталонной задаче. Запасные модели работают по списку fallbacks, который вы пишете сами, а каждая модель из списка становится ещё одним получателем ваших данных. Каждое переключение попадает в журнал, и по нему видно, где основной провайдер подводит.
Primary и провайдер
Модель задаётся строкой вида provider/model в поле agents.defaults.model.primary, а доступ к провайдеру обеспечивает профиль авторизации, который создаёт openclaw onboard.
Страница про выбор моделей описывает порядок так: сначала войдите у провайдера, затем запишите модель по умолчанию в конфигурацию. Провайдеров в каталоге OpenClaw много, от облачных вендоров до сервисов для отдельных задач. Профиль авторизации бывает трёх видов: ключ API, OAuth или статический токен. Профили хранятся в базе агента, а идентификатор по умолчанию строится как провайдер и слово default, поэтому два ключа одного вендора различаются именами.
Помимо сервисов вендоров есть открытые веса на своём или арендованном сервере: вы ставите модель сами и подключаете её как локального провайдера. С сервисом зарубежного вендора вопрос оплаты решается до выбора модели. Как поднять такую модель, показано в статье про Ollama API для своих сервисов, а подбор размера под задачу разобран в материале про Qwen через Ollama.
Критерии выбора запишите заранее, до сравнения моделей: качество русского текста, надёжность вызова инструментов, длина контекста, допустимое место обработки данных. Общая картина про границу периметра дана в разборе локального ИИ-агента. Название провайдера в записи об изменении должно стоять рядом с причиной выбора.
Проверка tools
Агент OpenClaw действует через инструменты, поэтому модель, которая красиво пишет и плохо вызывает функции, опасна именно как агент. Сравнивайте кандидатов на эталонной задаче: небольшом наборе заданий с известным правильным результатом, который лежит в репозитории и запускается скриптом. Спорные ответы оценивает человек, а скрипт только собирает вызовы и итоги.
- Составьте пять-семь заданий, где нужный инструмент и его аргументы известны заранее: чтение справочника, поиск записи, подготовка черновика.
- Добавьте задание, где инструмент возвращает ошибку, и проверьте, что агент сообщает о ней и признаёт отсутствие результата.
- Добавьте задание, где подходящего инструмента нет, и убедитесь, что агент останавливается и просит помощи.
- Прогоните набор для каждой модели-кандидата с одинаковыми инструкциями и сохраните журнал вызовов рядом с версией набора.
- Сопоставьте вызовы с эталоном: верный инструмент, верные аргументы, отсутствие лишних действий, понятный итог на русском.
Отдельно оцените язык. Эталонные задания пишите на русском и берите формулировки из реальной работы: обращения клиентов, внутренние регламенты, названия ваших продуктов. Модель, которая уверенно справляется с английскими примерами из документации, на русском канцелярите ошибается иначе. Хорошо, когда в наборе есть задание с близкими по названию инструментами: оно быстро показывает, путает ли модель аргументы.
Повторяйте тот же набор при смене модели, при замене версии у провайдера и после обновления OpenClaw. Решение о смене primary принимает владелец процесса и фиксирует вместе с результатом прогона. Автоматический показатель удобен для сравнения, а итоговое суждение остаётся за человеком, который знает цену ошибки в вашей задаче.
Явный fallback
По описанию failover OpenClaw действует в два этапа. Сначала система ротирует профили авторизации внутри текущего провайдера, затем переходит к следующей модели из списка agents.defaults.model.fallbacks. Запасной путь возникает только при явной записи. Ниже собрано, как источник выбора модели влияет на поведение.
- Модель по умолчанию из конфигурации использует общий список fallbacks.
- Primary конкретного агента работает строго, пока в его записи нет собственного списка fallbacks.
- Модель, выбранная сотрудником командой
/model, работает строго, без запасного пути. - Для задач по расписанию действует список из самой задачи либо общий список конфигурации.
- Автоматическое переключение живёт один ход, а на следующем ходу система возвращается к выбранной модели.
Первый уровень защиты дешевле второго: заведите два профиля авторизации у основного провайдера, например рабочий ключ и резервный. Порядок их использования закрепляется командой openclaw models auth order set --provider <id> с перечнем профилей либо параметром auth.order в конфигурации. Тогда сбой одного ключа или исчерпанная квота обходятся без смены модели и без передачи данных другому получателю.
Практический вывод: список fallbacks короткий и осмысленный. Одна-две запасные модели другого провайдера дают защиту от сбоя вендора, а длинная цепочка превращает качество ответа в лотерею. Каждую запись проверьте по политике данных, ведь при переключении запрос уйдёт другому получателю.
Какой процесс вашей команды первым получит запасную модель?
Что переключает
Заменой модели лечится лишь часть ошибок. Документация перечисляет сигналы, которые запускают переключение, и сигналы, которые остаются при вас. Эту таблицу полезно повесить рядом с журналом: она подсказывает, где нужна правка запроса, а где хватит ожидания.
| Сигнал | Переключение | Что делает команда |
|---|---|---|
| Ошибка авторизации | Да, сначала ротация профилей | Проверить ключ и срок токена |
| Лимит запросов, перегрузка провайдера | Да | Разнести нагрузку по профилям |
| Таймаут | Да | Посмотреть статус провайдера |
| Отключение биллинга у провайдера | Да, с паузой на возврат | Пополнить счёт, проверить уведомления |
| Отсутствие модели (404) | Да | Исправить имя модели в конфигурации |
| Переполнение контекста | Нет | Сократить вход, разбить задачу |
| Отказ провайдера по содержанию | Нет | Пересмотреть запрос и данные |
| Ошибка формата или проверки | Нет | Поправить вызов инструмента |
Для профилей действует охлаждение: профиль после сбоя уходит в конец очереди, и пауза растёт при повторах. Через retry.provider.maxRetries настраивается число повторных попыток. Выбранный профиль авторизации закрепляется за сессией ради кэша, поэтому ротация идёт после сброса сессии командами /new и /reset либо при уходе профиля в паузу.
Для людей, которые разбирают сбои, добавьте в таблицу четвёртый столбец с именем ответственного. Ошибки авторизации и биллинга обычно решает администратор, отказы по содержанию разбирает владелец процесса, а переполнение контекста возвращается к автору инструкции. Тогда после ночного переключения утром ясно, кому писать, и разбор идёт по делу, а поиск виноватого отпадает.
Журнал переключений
OpenClaw пишет структурированные записи model_fallback_decision. В них есть исходная и целевая модели, причина и детали сбоя, итог шага. Именно эти поля и читайте, потому что запасная модель, которая отвечает без сбоев, всё равно скрывает проблему у основной.
Решение о смене списка принимает владелец процесса вместе с администратором Gateway. Запись об изменении содержит прежний и новый список, дату, результат эталонного прогона и ссылку на политику данных. Так через месяц видно, почему в списке стоит именно эта модель и кто разрешил передавать ей запросы агента.
Раз в неделю просматривайте журнал по трём вопросам. Как часто основной провайдер выходит из строя и по какой причине. Совпадает ли качество на запасной модели с эталонным набором. Есть ли переключения, оставшиеся незамеченными. Если запасная модель отвечает заметно хуже, перенесите её в хвост списка либо уберите, а процесс при сбое переведите на ручную обработку. Данные, которые попали к другому провайдеру, отметьте в журнале как факт.
Запишите один primary, одну запасную модель другого провайдера и эталонный набор из пяти заданий. Отключите основной профиль в тестовой среде и посмотрите, как выглядит запись переключения. Сравнение моделей на ваших данных входит в консалтинг по внедрению ИИ.
Частые вопросы
Как выбрать модель в OpenClaw?
openclaw onboard и запишите модель по умолчанию в формате provider/model в поле primary. До постоянного использования прогоните эталонную задачу с вызовом инструментов.Как настроить fallback в OpenClaw?
agents.defaults.model.fallbacks. Сначала система ротирует профили авторизации внутри провайдера, затем переходит к следующей модели списка. Проверьте каждую запись по политике данных.