🧠 Model Fallback — как агент выбирает модель при сбое API

Вы даёте агенту Claude Opus как основную модель. Отлично. Но вдруг Anthropic API упал. Что делать? Переходить на GPT? Ждать часов?

Fallback — это автоматическое переключение на резервную модель.

Как работает:

1. Основная модель — Claude Opus (выбираете в конфиге)
2. Попытка запроса → Если ошибка → Переход к fallback
3. Fallback-цепочка — пробуются по очереди: Sonnet → GPT → Gemini
4. Успех → используется та модель, которая ответила

Когда включается fallback:

• rate_limit — API перегружен, получили HTTP 429
• auth_error — неверный API-ключ или истёк
• model_not_found — модель снята с производства
• timeout — сервер не ответил за N секунд
• server_error — Internal Server Error 500

Конфиг fallback-цепочки:

{
  "agents": {
    "defaults": {
      "model": "claude-opus-4-6",
      "fallback": [
        "claude-sonnet-4-6",
        "gpt-4-turbo",
        "gemini-3.1"
      ]
    }
  }
}

Если Opus недоступен:

1. Пробует Sonnet
2. Если Sonnet недоступен → пробует GPT
3. Если GPT недоступен → пробует Gemini
4. Если Gemini недоступен → ошибка

Fallback vs Retry:

❌ Retry — повторить тот же запрос к той же модели
✅ Fallback — попробовать другую модель

Retry имеет смысл при временных ошибках (сеть упала на 1 сек). Fallback — при стабильном сбое провайдера.

Лучшие практики:

🎯 Основная модель должна быть лучшей по качеству

• Claude Opus — самый умный, но дорогой

💰 Fallback должны быть дешевле/быстрее

• Sonnet (быстрее, дешевле чем Opus)
• GPT-4 Turbo (хороший качество/цена)
• Gemini (самый дешёвый, но работает)

⚠️ Не смешивайте несовместимые модели

• Claude и GPT имеют разное поведение в system prompts
• Gemini другой формат для изображений
• Лучше держать в цепочке модели с похожим поведением

Пример реальной цепочки:

{
  "model": "claude-opus-4-6",
  "fallback": [
    "claude-sonnet-4-6",      // тот же провайдер, дешевле
    "gpt-4-turbo",            // другой провайдер, похожий уровень
    "gemini-2.0-flash"        // дешёвый вариант
  ]
}

Мониторинг fallback:

openclaw models status --probe

Покажет статус каждой модели: доступна ли, есть ли ошибки, есть ли cooldown.

Что НЕ является fallback:

❌ Автоматическое переключение потому что "модель А медленнее"
❌ Случайный выбор из N моделей
❌ Переключение потому что "пользователю не понравился ответ"

Fallback — это только при ошибке API.

Fallback — ваша страховка от перебоев провайдеров. Правильная цепочка = надёжный агент.

🔗 OpenClaw — open-source платформа для ИИ-агентов
📖 docs.openclaw.ai

Подпишитесь на @openclawc