Провайдеры и модели

· 5 мин чтения · admin

OpenClaw поддерживает более 35 провайдеров ИИ-моделей. Вы выбираете провайдер, вводите API-ключ — и агент работает.

Быстрый старт

  • Получите API-ключ у провайдера (см. таблицу ниже)
  • Запустите онбординг: openclaw onboard
  • Выберите провайдер и введите ключ

    • Или настройте вручную в ~/.openclaw/openclaw.json:

    {
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-sonnet-4-6" },
    },
  },
}

    Формат модели: провайдер/модель. Примеры: openai/gpt-5.5, anthropic/claude-opus-4-6, google/gemini-3-flash-preview.

    CLI-помощники

    openclaw models list                          # все доступные модели
openclaw models list --provider openai        # модели конкретного провайдера
openclaw models set anthropic/claude-sonnet-4-6  # сменить модель
openclaw models auth login --provider openai  # авторизация

    Топ провайдеров

    Провайдер Модели Бесплатный тир Ссылка
    **OpenAI** GPT-5.5, GPT-5.4, o3, o4-mini Нет platform.openai.com
    **Anthropic** Claude Opus 4, Sonnet 4, Haiku Нет console.anthropic.com
    **Google** Gemini 3.1 Pro, Gemini 3 Flash Да aistudio.google.com
    **DeepSeek** DeepSeek V3, R1 Да platform.deepseek.com
    **Mistral** Mistral Large, Medium Нет console.mistral.ai
    **Groq** Llama, Mixtral (быстрые) Да console.groq.com
    **OpenRouter** Доступ ко всем моделям Да openrouter.ai
    **Ollama** Локальные модели (Llama, Qwen…) Да (локально) ollama.com
    **xAI** Grok Нет console.x.ai
    **OpenCode** Claude, Kimi (через Zen/Go) Нет opencode.ai
    **Xiaomi** MiMo Да direct API
    Полный список провайдеров

    Alibaba Model Studio, Amazon Bedrock, Anthropic, BytePlus, Chutes, ComfyUI, Cloudflare AI Gateway, fal, Fireworks, GLM, MiniMax, Mistral, Moonshot AI (Kimi), OpenAI, OpenCode, OpenRouter, Qianfan, Qwen, Runway, StepFun, Synthetic, Vercel AI Gateway, Venice, xAI, Z.AI и другие.

    Дополнительные варианты: anthropic-vertex (Google Vertex), copilot-proxy (VS Code Copilot), google-gemini-cli (Gemini CLI OAuth).

    Авторизация

    Каждый провайдер использует свою переменную окружения:

    Провайдер Переменная Ротация ключей
    OpenAI `OPENAI_API_KEY` `OPENAI_API_KEYS`, `OPENAI_API_KEY_1`, `OPENAI_API_KEY_2`
    Anthropic `ANTHROPIC_API_KEY` `ANTHROPIC_API_KEYS`, `ANTHROPIC_API_KEY_1`
    Google `GEMINI_API_KEY` `GEMINI_API_KEYS`, `GOOGLE_API_KEY` (fallback)
    OpenCode `OPENCODE_API_KEY` —

    Ротация: при ошибке 429 (rate limit) OpenClaw автоматически переключается на следующий ключ. Не-rate-limit ошибки фейлятся сразу.

    Настройка нескольких моделей

    Можно указать запасные модели на случай, если основная недоступна:

    {
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-sonnet-4-6",
        fallbacks: ["openai/gpt-5.5", "google/gemini-3.1-pro-preview"],
      },
      models: {
        "anthropic/claude-sonnet-4-6": { alias: "sonnet" },
        "openai/gpt-5.5": { alias: "gpt" },
        "google/gemini-3.1-pro-preview": { alias: "gemini" },
      },
    },
  },
}

    models — каталог и allowlist для команды /model в чате.

    Context window и maxTokens

    Можно переопределить лимиты на уровне провайдера или модели:

    {
  models: {
    providers: {
      "openai-codex": {
        models: [{ id: "gpt-5.5", contextTokens: 160000 }],
      },
    },
  },
}

    Failover (резервирование)

    OpenClaw обрабатывает сбои в два этапа:

  • Ротация auth-профилей — если у провайдера несколько API-ключей, OpenClaw переключается между ними при 429/timeout
  • Fallback на следующую модель — если все профили исчерпаны, переходит к следующей модели в fallbacks

    • Auth-профили хранятся в ~/.openclaw/agents//agent/auth-profiles.json. При сбое профиль уходит в cooldown.

    Сессия «прилипает» к одному профилю (session stickiness) — ротация происходит только при сбросе сессии (/new), compaction или cooldown.

    Переключение в чате

    Если настроено несколько моделей, можно переключаться командой:

    /model openai/gpt-5.5

    OpenAI vs OpenAI Codex

    OpenAI имеет два маршрута:

  • openai/gpt-5.5 — прямой API-ключ
  • openai-codex/gpt-5.5 — OAuth через ChatGPT (подписка)

    • Если используете Codex OAuth: openclaw onboard --auth-choice openai-codex.

    Thinking (режимы мышления)

    Некоторые модели поддерживают расширенное мышление:

    /think high
/think low
/think adaptive    # Google dynamic thinking

    Модели Gemini 3/3.1 используют динамический thinking, Gemini 2.5 — thinkingBudget: -1.

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

    Если вы хотите запустить модель на своём компьютере без API-ключей:

  • Установите Ollama: ollama.com
  • Скачайте модель: ollama pull llama3.1
  • Настройте OpenClaw:
    • {
  agents: {
    defaults: {
      model: { primary: "ollama/llama3.1" },
    },
  },
}

    Локальные модели работают бесплатно, но требуют достаточно RAM (от 8 ГБ для небольших моделей).

    Ollama в Docker

    Когда OpenClaw работает в Docker, 127.0.0.1 — это контейнер, а не хост. Используйте host.docker.internal:

    {
  providers: {
    ollama: { baseUrl: "http://host.docker.internal:11434" },
  },
}

    Self-hosted провайдеры

    Если вы запускаете свою модель через vLLM, SGLang или другой OpenAI-совместимый сервер:

    {
  models: {
    mode: "merge",
    providers: {
      custom: {
        baseUrl: "http://localhost:8000/v1",
        apiKey: "your-key",
        api: "openai-responses",
        models: [
          { id: "my-model", name: "My Custom Model" },
        ],
      },
    },
  },
}

    OAuth и подписочная авторизация

    OpenClaw поддерживает OAuth для провайдеров с подписочной моделью (прежде всего OpenAI Codex / ChatGPT OAuth).

    Поддерживаемые OAuth-потоки

    OpenAI Codex ChatGPT OAuth (подписка)
    Anthropic Claude CLI Переиспользование локального логина
    Gemini CLI Google OAuth

    Как запустить

    openclaw models auth login --provider openai-codex
openclaw models auth login --provider anthropic --method cli --set-default

    Хранение токенов

    Профили авторизации (OAuth + API-ключи): ~/.openclaw/agents/<agentId>/agent/auth-profiles.json

    OpenClaw treats этот файл как token sink — единое место хранения. При использовании внешнего CLI (Codex CLI, Claude CLI) OpenClaw зеркалирует токены с провенансом вместо самостоятельной ротации.

    Несколько аккаунтов

    Используйте профили для маршрутизации между аккаунтами одного провайдера. Переопределение per-session через /model или конфигурацию.

    Важно

    • Для Anthropic в продакшене API-ключ безопаснее OAuth
    • Не логинитесь одновременно через OpenClaw и внешний CLI — один из них может «разлогиниться»

    Что дальше

  • Конфигурация Gateway — общие настройки
  • Все провайдеры — полный справочник
  • Мультиагентность — разные модели для разных агентов