Поставщики моделей

Справочник по провайдерам LLM/моделей (не чат-каналам вроде WhatsApp/Telegram). Правила выбора моделей см. в Модели.

Краткие правила

Поведение провайдера, принадлежащее Plugin

Большая часть логики, специфичной для провайдера, находится в Plugin провайдеров (registerProvider(...)), тогда как OpenClaw сохраняет общий цикл inference. Plugin владеют onboarding, каталогами моделей, сопоставлением env var для аутентификации, нормализацией транспорта/конфигурации, очисткой схем инструментов, классификацией failover, обновлением OAuth, отчетами об использовании, профилями thinking/reasoning и многим другим.

Полный список хуков provider-SDK и примеров встроенных Plugin находится в Plugin провайдеров. Провайдер, которому нужен полностью пользовательский исполнитель запросов, является отдельной, более глубокой поверхностью расширения.

Ротация API-ключей

Официальные Plugin провайдеров

Официальные Plugin провайдеров публикуют собственные строки каталога моделей. Этим провайдерам не нужны записи моделей models.providers; включите Plugin провайдера, задайте аутентификацию и выберите модель. Используйте models.providers только для явных пользовательских провайдеров или узких настроек запросов, таких как тайм-ауты.

OpenAI

• Провайдер: openai
• Аутентификация: OPENAI_API_KEY
• Необязательная ротация: OPENAI_API_KEYS, OPENAI_API_KEY_1, OPENAI_API_KEY_2, плюс OPENCLAW_LIVE_OPENAI_KEY (одиночное переопределение)
• Примеры моделей: openai/gpt-5.5, openai/gpt-5.4-mini
• Проверяйте доступность аккаунта/модели с помощью openclaw models list --provider openai, если конкретная установка или API-ключ ведет себя иначе.
• CLI: openclaw onboard --auth-choice openai-api-key
• Транспорт по умолчанию — auto; OpenClaw передает выбор транспорта в общий runtime модели.
• Переопределение для отдельной модели через agents.defaults.models["openai/<model>"].params.transport ("sse", "websocket" или "auto")
• Приоритетную обработку OpenAI можно включить через agents.defaults.models["openai/<model>"].params.serviceTier
• /fast и params.fastMode сопоставляют прямые запросы Responses openai/* с service_tier=priority на api.openai.com
• Используйте params.serviceTier, когда нужен явный уровень вместо общего переключателя /fast
• Скрытые заголовки атрибуции OpenClaw (originator, version, User-Agent) применяются только к нативному трафику OpenAI на api.openai.com, а не к универсальным OpenAI-совместимым прокси
• Нативные маршруты OpenAI также сохраняют Responses store, подсказки prompt-cache и формирование payload, совместимое с reasoning OpenAI; прокси-маршруты этого не делают
• openai/gpt-5.3-codex-spark доступен через аутентификацию подписки ChatGPT/Codex OAuth, когда ваш вошедший аккаунт его предоставляет; OpenClaw все еще подавляет прямые маршруты OpenAI API-key и Azure API-key для этой модели, потому что эти транспорты ее отклоняют

{  agents: { defaults: { model: { primary: "openai/gpt-5.5" } } },}

Anthropic

• Провайдер: anthropic
• Аутентификация: ANTHROPIC_API_KEY
• Необязательная ротация: ANTHROPIC_API_KEYS, ANTHROPIC_API_KEY_1, ANTHROPIC_API_KEY_2, плюс OPENCLAW_LIVE_ANTHROPIC_KEY (одиночное переопределение)
• Пример модели: anthropic/claude-opus-4-6
• CLI: openclaw onboard --auth-choice apiKey
• Прямые публичные запросы Anthropic поддерживают общий переключатель /fast и params.fastMode, включая трафик с API-ключом и OAuth-аутентификацией, отправленный на api.anthropic.com; OpenClaw сопоставляет это с Anthropic service_tier (auto против standard_only)
• Предпочтительная конфигурация Claude CLI сохраняет ссылку на модель канонической и выбирает CLI backend отдельно: anthropic/claude-opus-4-8 с agentRuntime.id: "claude-cli" в области модели. Устаревшие ссылки claude-cli/claude-opus-4-7 все еще работают для совместимости.

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

OpenAI ChatGPT/Codex OAuth

• Провайдер: openai
• Аутентификация: OAuth (ChatGPT)
• Устаревшая ссылка на модель OpenAI Codex: openai/gpt-5.5
• Ссылка нативного harness сервера приложений Codex: openai/gpt-5.5
• Документация нативного harness сервера приложений Codex: harness Codex
• Устаревшие ссылки на модели: codex/gpt-*
• Граница Plugin: openai/* загружает Plugin OpenAI; нативный Plugin сервера приложений Codex выбирается runtime harness Codex.
• CLI: openclaw onboard --auth-choice openai или openclaw models auth login --provider openai
• Транспорт по умолчанию — auto (сначала WebSocket, fallback на SSE)
• Переопределение для отдельной модели OpenAI Codex через agents.defaults.models["openai/<model>"].params.transport ("sse", "websocket" или "auto")
• params.serviceTier также передается в нативных запросах Codex Responses (chatgpt.com/backend-api)
• Скрытые заголовки атрибуции OpenClaw (originator, version, User-Agent) добавляются только к нативному трафику Codex на chatgpt.com/backend-api, а не к универсальным OpenAI-совместимым прокси
• Использует тот же переключатель /fast и конфигурацию params.fastMode, что и прямой openai/*; OpenClaw сопоставляет это с service_tier=priority
• openai/gpt-5.5 использует нативные значения каталога Codex contextWindow = 400000 и runtime по умолчанию contextTokens = 272000; переопределите ограничение runtime через models.providers.openai.models[].contextTokens
• Примечание о политике: OpenAI Codex OAuth явно поддерживается для внешних инструментов/рабочих процессов вроде OpenClaw.
• Для обычного маршрута подписка плюс нативный runtime Codex войдите через аутентификацию openai и настройте openai/gpt-5.5; ходы агента OpenAI по умолчанию выбирают Codex.
• Используйте agentRuntime.id: "openclaw" на уровне провайдера/модели только когда нужен встроенный маршрут OpenClaw; иначе оставьте openai/gpt-5.5 на harness Codex по умолчанию.
• устаревшие ссылки Codex GPT являются устаревшим состоянием, а не live-маршрутом провайдера. Используйте openai/gpt-5.5 на нативном runtime Codex для новой конфигурации агента и запустите openclaw doctor --fix, чтобы мигрировать старые устаревшие ссылки на модели Codex в канонические ссылки openai/*.

{  plugins: { entries: { codex: { enabled: true } } },  agents: {    defaults: {      model: { primary: "openai/gpt-5.5" },    },  },}

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

Другие размещенные варианты в стиле подписки

OpenCode

• Аутентификация: OPENCODE_API_KEY (или OPENCODE_ZEN_API_KEY)
• Провайдер Zen runtime: opencode
• Провайдер Go runtime: opencode-go
• Примеры моделей: opencode/claude-opus-4-6, opencode-go/kimi-k2.6
• CLI: openclaw onboard --auth-choice opencode-zen или openclaw onboard --auth-choice opencode-go

{  agents: { defaults: { model: { primary: "opencode/claude-opus-4-6" } } },}

Google Gemini (API-ключ)

• Провайдер: google
• Аутентификация: GEMINI_API_KEY
• Необязательная ротация: GEMINI_API_KEYS, GEMINI_API_KEY_1, GEMINI_API_KEY_2, резервный GOOGLE_API_KEY и OPENCLAW_LIVE_GEMINI_KEY (одиночное переопределение)
• Примеры моделей: google/gemini-3.1-pro-preview, google/gemini-3-flash-preview
• Совместимость: устаревшая конфигурация OpenClaw, использующая google/gemini-3.1-flash-preview, нормализуется в google/gemini-3-flash-preview
• Псевдоним: google/gemini-3.1-pro принимается и нормализуется в актуальный идентификатор Google Gemini API, google/gemini-3.1-pro-preview
• CLI: openclaw onboard --auth-choice gemini-api-key
• Мышление: /think adaptive использует динамическое мышление Google. Gemini 3/3.1 не указывают фиксированный thinkingLevel; Gemini 2.5 отправляет thinkingBudget: -1.
• Прямые запуски Gemini также принимают agents.defaults.models["google/<model>"].params.cachedContent (или устаревшее cached_content) для передачи собственного для провайдера дескриптора cachedContents/...; попадания в кэш Gemini отображаются как OpenClaw cacheRead

Google Vertex и Gemini CLI

• Провайдеры: google-vertex, google-gemini-cli
• Аутентификация: Vertex использует gcloud ADC; Gemini CLI использует свой OAuth-поток

Gemini CLI OAuth поставляется как часть встроенного Plugin google.

brew install gemini-cli

npm install -g @google/gemini-cli

openclaw plugins enable google

openclaw models auth login --provider google-gemini-cli --set-default

Gemini CLI по умолчанию использует stream-json. OpenClaw читает потоковые сообщения ассистента и нормализует stats.cached в cacheRead; устаревшие переопределения --output-format json по-прежнему читают текст ответа из response.

Z.AI (GLM)

• Провайдер: zai
• Аутентификация: ZAI_API_KEY
• Пример модели: zai/glm-5.2
• CLI: openclaw onboard --auth-choice zai-api-key
  • Ссылки на модели используют канонический идентификатор провайдера zai/*.
  • zai-api-key автоматически определяет соответствующий эндпоинт Z.AI; zai-coding-global, zai-coding-cn, zai-global и zai-cn принудительно выбирают конкретную поверхность

Vercel AI Gateway

• Провайдер: vercel-ai-gateway
• Аутентификация: AI_GATEWAY_API_KEY
• Примеры моделей: vercel-ai-gateway/anthropic/claude-opus-4.6, vercel-ai-gateway/moonshotai/kimi-k2.6
• CLI: openclaw onboard --auth-choice ai-gateway-api-key

Другие встроенные Plugin провайдеров

Особенности, о которых стоит знать

Провайдеры через models.providers (пользовательский/base URL)

Используйте models.providers (или models.json), чтобы добавить пользовательских провайдеров или OpenAI/Anthropic-совместимые прокси.

Многие из перечисленных ниже встроенных плагинов провайдеров уже публикуют каталог по умолчанию. Используйте явные записи models.providers.<id> только если нужно переопределить базовый URL, заголовки или список моделей.

Проверки возможностей моделей Gateway также читают явные метаданные models.providers.<id>.models[]. Если пользовательская или прокси-модель принимает изображения, задайте для этой модели input: ["text", "image"], чтобы WebChat и пути вложений от узлов передавали изображения как нативные входные данные модели, а не как текстовые ссылки на медиа.

agents.defaults.models["provider/model"] управляет только видимостью модели, псевдонимами и метаданными отдельных моделей для агентов. Сам по себе он не регистрирует новую runtime-модель. Для пользовательских моделей провайдера также добавьте models.providers.<provider>.models[] как минимум с соответствующим id.

Moonshot AI (Kimi)

Установите @openclaw/moonshot-provider перед онбордингом. Добавляйте явную запись models.providers.moonshot только если нужно переопределить базовый URL или метаданные модели:

• Провайдер: moonshot
• Аутентификация: MOONSHOT_API_KEY
• Пример модели: moonshot/kimi-k2.6
• CLI: openclaw onboard --auth-choice moonshot-api-key или openclaw onboard --auth-choice moonshot-api-key-cn

Идентификаторы моделей Kimi K2:

• moonshot/kimi-k2.6
• moonshot/kimi-k2.7-code
• moonshot/kimi-k2.5
• moonshot/kimi-k2-thinking
• moonshot/kimi-k2-thinking-turbo
• moonshot/kimi-k2-turbo

{  agents: {    defaults: { model: { primary: "moonshot/kimi-k2.6" } },  },  models: {    mode: "merge",    providers: {      moonshot: {        baseUrl: "https://api.moonshot.ai/v1",        apiKey: "${MOONSHOT_API_KEY}",        api: "openai-completions",        models: [{ id: "kimi-k2.6", name: "Kimi K2.6" }],      },    },  },}

Kimi для кодинга

Kimi Coding использует совместимый с Anthropic endpoint Moonshot AI:

• Провайдер: kimi
• Аутентификация: KIMI_API_KEY
• Пример модели: kimi/kimi-for-coding

{  env: { KIMI_API_KEY: "sk-..." },  agents: {    defaults: { model: { primary: "kimi/kimi-for-coding" } },  },}

Устаревшие kimi/kimi-code и kimi/k2p5 по-прежнему принимаются как совместимые идентификаторы моделей и нормализуются в стабильный идентификатор API-модели Kimi.

Volcano Engine (Doubao)

Volcano Engine (火山引擎) предоставляет доступ к Doubao и другим моделям в Китае.

• Провайдер: volcengine (кодинг: volcengine-plan)
• Аутентификация: VOLCANO_ENGINE_API_KEY
• Пример модели: volcengine-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice volcengine-api-key

{  agents: {    defaults: { model: { primary: "volcengine-plan/ark-code-latest" } },  },}

При онбординге по умолчанию используется поверхность для кодинга, но общий каталог volcengine/* регистрируется одновременно.

В средствах выбора моделей при онбординге/настройке вариант аутентификации Volcengine предпочитает строки как volcengine/*, так и volcengine-plan/*. Если эти модели еще не загружены, OpenClaw использует нефильтрованный каталог вместо того, чтобы показывать пустой выбор моделей, ограниченный поставщиком.

BytePlus (международный)

BytePlus ARK предоставляет международным пользователям доступ к тем же моделям, что и Volcano Engine.

• Поставщик: byteplus (кодинг: byteplus-plan)
• Аутентификация: BYTEPLUS_API_KEY
• Пример модели: byteplus-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice byteplus-api-key

{  agents: {    defaults: { model: { primary: "byteplus-plan/ark-code-latest" } },  },}

При онбординге по умолчанию используется поверхность для кодинга, но общий каталог byteplus/* регистрируется одновременно.

В средствах выбора моделей при онбординге/настройке вариант аутентификации BytePlus предпочитает строки как byteplus/*, так и byteplus-plan/*. Если эти модели еще не загружены, OpenClaw использует нефильтрованный каталог вместо того, чтобы показывать пустой выбор моделей, ограниченный поставщиком.

Synthetic

Synthetic предоставляет Anthropic-совместимые модели через поставщика synthetic:

• Поставщик: synthetic
• Аутентификация: SYNTHETIC_API_KEY
• Пример модели: synthetic/hf:MiniMaxAI/MiniMax-M2.5
• CLI: openclaw onboard --auth-choice synthetic-api-key

{  agents: {    defaults: { model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.5" } },  },  models: {    mode: "merge",    providers: {      synthetic: {        baseUrl: "https://api.synthetic.new/anthropic",        apiKey: "${SYNTHETIC_API_KEY}",        api: "anthropic-messages",        models: [{ id: "hf:MiniMaxAI/MiniMax-M2.5", name: "MiniMax M2.5" }],      },    },  },}

MiniMax

MiniMax настраивается через models.providers, потому что использует пользовательские конечные точки:

• MiniMax OAuth (глобальный): --auth-choice minimax-global-oauth
• MiniMax OAuth (Китай): --auth-choice minimax-cn-oauth
• API-ключ MiniMax (глобальный): --auth-choice minimax-global-api
• API-ключ MiniMax (Китай): --auth-choice minimax-cn-api
• Аутентификация: MINIMAX_API_KEY для minimax; MINIMAX_OAUTH_TOKEN или MINIMAX_API_KEY для minimax-portal

См. /providers/minimax для подробностей настройки, вариантов моделей и фрагментов конфигурации.

Разделение возможностей, принадлежащее Plugin:

• Значения по умолчанию для текста/чата остаются на minimax/MiniMax-M3
• Генерация изображений — minimax/image-01 или minimax-portal/image-01
• Понимание изображений — принадлежащая Plugin модель MiniMax-VL-01 на обоих путях аутентификации MiniMax
• Веб-поиск остается на идентификаторе поставщика minimax

LM Studio

LM Studio поставляется как встроенный Plugin поставщика, который использует нативный API:

• Поставщик: lmstudio
• Аутентификация: LM_API_TOKEN
• Базовый URL вывода по умолчанию: http://localhost:1234/v1

Затем задайте модель (замените на один из идентификаторов, возвращаемых http://localhost:1234/api/v1/models):

{  agents: {    defaults: { model: { primary: "lmstudio/openai/gpt-oss-20b" } },  },}

OpenClaw использует нативные /api/v1/models и /api/v1/models/load LM Studio для обнаружения и автозагрузки, а /v1/chat/completions по умолчанию — для вывода. Если вы хотите, чтобы JIT-загрузка LM Studio, TTL и автоматическое вытеснение управляли жизненным циклом модели, задайте models.providers.lmstudio.params.preload: false. См. /providers/lmstudio для настройки и устранения неполадок.

Ollama

Ollama поставляется как встроенный Plugin поставщика и использует нативный API Ollama:

• Поставщик: ollama
• Аутентификация: не требуется (локальный сервер)
• Пример модели: ollama/llama3.3
• Установка: https://ollama.com/download

# Install Ollama, then pull a model:ollama pull llama3.3

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

Ollama обнаруживается локально по адресу http://127.0.0.1:11434, когда вы включаете ее через OLLAMA_API_KEY, а встроенный Plugin поставщика добавляет Ollama напрямую в openclaw onboard и средство выбора моделей. См. /providers/ollama для онбординга, облачного/локального режима и пользовательской конфигурации.

vLLM

vLLM поставляется как встроенный Plugin поставщика для локальных или самостоятельно размещенных OpenAI-совместимых серверов:

• Поставщик: vllm
• Аутентификация: необязательно (зависит от вашего сервера)
• Базовый URL по умолчанию: http://127.0.0.1:8000/v1

Чтобы включить локальное автообнаружение (подойдет любое значение, если ваш сервер не требует аутентификацию):

export VLLM_API_KEY="vllm-local"

Затем задайте модель (замените на один из идентификаторов, возвращаемых /v1/models):

{  agents: {    defaults: { model: { primary: "vllm/your-model-id" } },  },}

См. /providers/vllm для подробностей.

SGLang

SGLang поставляется как встроенный Plugin поставщика для быстрых самостоятельно размещенных OpenAI-совместимых серверов:

• Поставщик: sglang
• Аутентификация: необязательно (зависит от вашего сервера)
• Базовый URL по умолчанию: http://127.0.0.1:30000/v1

Чтобы включить локальное автообнаружение (подойдет любое значение, если ваш сервер не требует аутентификацию):

export SGLANG_API_KEY="sglang-local"

Затем задайте модель (замените на один из идентификаторов, возвращаемых /v1/models):

{  agents: {    defaults: { model: { primary: "sglang/your-model-id" } },  },}

См. /providers/sglang для подробностей.

Локальные прокси (LM Studio, vLLM, LiteLLM и т. д.)

Пример (OpenAI-совместимый):

{  agents: {    defaults: {      model: { primary: "lmstudio/my-local-model" },      models: { "lmstudio/my-local-model": { alias: "Local" } },    },  },  models: {    providers: {      lmstudio: {        baseUrl: "http://localhost:1234/v1",        apiKey: "${LM_API_TOKEN}",        api: "openai-completions",        timeoutSeconds: 300,        models: [          {            id: "my-local-model",            name: "Local Model",            reasoning: false,            input: ["text"],            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },            contextWindow: 200000,            maxTokens: 8192,          },        ],      },    },  },}

Примеры CLI

openclaw onboard --auth-choice opencode-zenopenclaw models set opencode/claude-opus-4-6openclaw models list

См. также: Конфигурация для полных примеров конфигурации.

Связанные материалы

• Справочник по конфигурации - ключи конфигурации моделей
• Отказоустойчивое переключение моделей - цепочки fallback и поведение повторных попыток
• Модели - конфигурация моделей и псевдонимы
• Поставщики - руководства по настройке для каждого поставщика