Модели в OpenClaw: провайдеры, failover, настройка

OpenClaw — не привязан к одной AI-модели. Вы можете использовать Claude от Anthropic, GPT от OpenAI, Gemini от Google, модели от xAI, Groq, Mistral и даже локальные модели через Ollama. В этой статье разберём все поддерживаемые провайдеры и как между ними переключаться.

Основные правила

• Ссылки на модели в формате provider/model (например, anthropic/claude-opus-4-6)
• Если указан agents.defaults.models, он становится белым списком доступных моделей
• CLI: openclaw models list, openclaw models set <provider/model>

Встроенные провайдеры

Эти провайдеры работают «из коробки» — нужен только API-ключ.

Anthropic (Claude)

• Провайдер: anthropic
• Авторизация: ANTHROPIC_API_KEY
• Пример: anthropic/claude-opus-4-6
• Лучший выбор для русского языка и агентных задач

OpenAI (GPT)

• Провайдер: openai
• Авторизация: OPENAI_API_KEY
• Пример: openai/gpt-5.1-codex

Google Gemini

• Провайдер: google
• Авторизация: GEMINI_API_KEY
• Пример: google/gemini-3-pro-preview
• Самый большой контекст и работа с видео

Другие встроенные

• OpenRouter (openrouter) — маршрутизатор моделей, удобен для доступа ко многим моделям через один API
• xAI Grok (xai)
• Groq (groq) — ультра-быстрый инференс
• Cerebras (cerebras) — быстрый инференс с поддержкой GLM
• Mistral (mistral)
• GitHub Copilot (github-copilot)
• Hugging Face (huggingface) — доступ к open-source моделям
• Z.AI (GLM) (zai)

Настройка основной модели и failover

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["openai/gpt-5.2"],
      },
    },
  },
}

Если основная модель недоступна, OpenClaw автоматически переключится на резервную.

Пользовательские провайдеры

Через models.providers можно подключить любой OpenAI/Anthropic-совместимый эндпоинт.

Ollama (локальные модели)

{
  agents: {
    defaults: { model: { primary: "ollama/llama3.3" } },
  },
}

Ollama автоматически обнаруживается на http://127.0.0.1:11434/v1. Бесплатно, приватно, без интернета.

Moonshot AI (Kimi)

{
  models: {
    providers: {
      moonshot: {
        baseUrl: "https://api.moonshot.ai/v1",
        apiKey: "${MOONSHOT_API_KEY}",
        api: "openai-completions",
        models: [{ id: "kimi-k2.5", name: "Kimi K2.5" }],
      },
    },
  },
}

LM Studio / vLLM / LiteLLM

Любой локальный прокси с OpenAI-совместимым API:

{
  models: {
    providers: {
      lmstudio: {
        baseUrl: "http://localhost:1234/v1",
        apiKey: "LMSTUDIO_KEY",
        api: "openai-completions",
        models: [{
          id: "minimax-m2.1",
          name: "MiniMax M2.1",
          contextWindow: 200000,
          maxTokens: 8192,
        }],
      },
    },
  },
}

Переключение моделей

В чате:

• /model opus — по алиасу
• /model anthropic/claude-sonnet-4-5 — по полному имени
• /new opus — новая сессия с другой моделью

Через CLI:

openclaw models set anthropic/claude-opus-4-6
openclaw models list

Подробнее о конфигурации OpenClaw и обзоре возможностей.