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

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

Быстрые правила

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

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

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

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

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

Официальные Plugins провайдеров публикуют собственные строки каталога моделей. Эти провайдеры не требуют записей моделей 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, когда нужен явный tier вместо общего переключателя /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-ключа и Azure API-ключа для этой модели, потому что эти транспорты ее отклоняют

{  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 с model-scoped 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 app-server: openai/gpt-5.5
• Документация нативного harness Codex app-server: harness Codex
• Устаревшие ссылки на модели: codex/gpt-*
• Граница Plugin: openai/* загружает Plugin OpenAI; нативный Plugin Codex app-server выбирается 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 по умолчанию.
• устаревшие GPT-ссылки Codex являются устаревшим состоянием, а не 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 }],      },    },  },}

Другие hosted-варианты в стиле подписки

OpenCode

• Авторизация: OPENCODE_API_KEY (или OPENCODE_ZEN_API_KEY)
• Провайдер runtime Zen: opencode
• Провайдер runtime Go: 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 принимается и нормализуется в актуальный идентификатор Gemini API от Google, 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.

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

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

agents.defaults.models["provider/model"] управляет только видимостью модели, псевдонимами и метаданными отдельных моделей для агентов. Сам по себе он не регистрирует новую модель времени выполнения. Для пользовательских моделей провайдера также добавьте 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-совместимую конечную точку 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/* регистрируется одновременно.

В средствах выбора модели для onboarding/configure вариант аутентификации 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" } },  },}

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

В средствах выбора модели для onboarding/configure вариант аутентификации 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 (Global): --auth-choice minimax-global-oauth
• MiniMax OAuth (CN): --auth-choice minimax-cn-oauth
• API-ключ MiniMax (Global): --auth-choice minimax-global-api
• API-ключ MiniMax (CN): --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-загрузка, TTL и автоматическое вытеснение LM Studio управляли жизненным циклом модели, задайте 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 для onboarding, облачного/локального режима и пользовательской конфигурации.

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

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

Смежные разделы

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