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

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

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

Model refs and CLI helpers

Ссылки на модели используют формат provider/model (пример: opencode/claude-opus-4-6).
agents.defaults.models при задании работает как список разрешенных моделей.
Вспомогательные команды CLI: openclaw onboard, openclaw models list, openclaw models set <provider/model>.
models.providers.*.contextWindow / contextTokens / maxTokens задают значения по умолчанию на уровне провайдера; models.providers.*.models[].contextWindow / contextTokens / maxTokens переопределяют их для каждой модели.
Правила fallback, проверки cooldown и сохранение переопределений сессии: Отказоустойчивое переключение моделей.

Adding provider auth does not change your primary model

openclaw configure сохраняет существующее значение agents.defaults.model.primary, когда вы добавляете или повторно авторизуете провайдера. openclaw models auth login делает то же самое, если не передать --set-default. Plugin провайдера все еще может вернуть рекомендуемую модель по умолчанию в патче конфигурации авторизации, но OpenClaw трактует это как «сделать эту модель доступной», если основная модель уже существует, а не как «заменить текущую основную модель».Чтобы намеренно переключить модель по умолчанию, используйте openclaw models set <provider/model> или openclaw models auth login --provider <id> --set-default.

OpenAI provider/runtime split

Маршруты семейства OpenAI зависят от префикса:

openai/<model> по умолчанию использует нативный harness Codex app-server для ходов агента. Это обычная настройка подписки ChatGPT/Codex.
Устаревшие ссылки на модели Codex являются устаревшей конфигурацией, которую doctor переписывает в openai/<model>.
openai/<model> плюс провайдер/модель agentRuntime.id: "openclaw" использует встроенный runtime OpenClaw для явных маршрутов API-ключа или совместимости.

См. OpenAI и harness Codex. Если разделение провайдера и runtime непонятно, сначала прочитайте runtime-ы агентов.Автовключение Plugin следует той же границе: ссылки агентов openai/* включают Plugin Codex для маршрута по умолчанию, а явные провайдер/модель agentRuntime.id: "codex" или устаревшие ссылки codex/<model> также требуют его.GPT-5.5 по умолчанию доступна через нативный harness Codex app-server в openai/gpt-5.5 и через runtime OpenClaw, когда политика runtime провайдера/модели явно выбирает openclaw.

CLI runtimes

Runtime-ы CLI используют то же разделение: выбирайте канонические ссылки на модели, такие как anthropic/claude-* или google/gemini-*, затем задавайте политику runtime провайдера/модели как claude-cli или google-gemini-cli, когда нужен локальный backend CLI.Устаревшие ссылки claude-cli/* и google-gemini-cli/* мигрируют обратно к каноническим ссылкам провайдера, при этом runtime записывается отдельно. Устаревшие ссылки codex-cli/* мигрируют в openai/* и используют маршрут Codex app-server; OpenClaw больше не сохраняет встроенный backend Codex CLI.

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

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

Поведение runner, принадлежащее провайдеру, находится в явных hooks провайдера, таких как политика replay, нормализация схем инструментов, оборачивание stream и вспомогательные средства транспорта/запросов. Устаревший статический набор ProviderPlugin.capabilities существует только для совместимости и больше не читается общей логикой runner.

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

Key sources and priority

Настраивайте несколько ключей через:

OPENCLAW_LIVE_<PROVIDER>_KEY (одиночное live-переопределение, самый высокий приоритет)
<PROVIDER>_API_KEYS (список через запятую или точку с запятой)
<PROVIDER>_API_KEY (основной ключ)
<PROVIDER>_API_KEY_* (нумерованный список, например <PROVIDER>_API_KEY_1)

Для провайдеров Google GOOGLE_API_KEY также включается как fallback. Порядок выбора ключей сохраняет приоритет и удаляет дубликаты значений.

When rotation kicks in

Запросы повторяются со следующим ключом только при ответах с rate limit (например 429, rate_limit, quota, resource exhausted, Too many concurrent requests, ThrottlingException, concurrency limit reached, workers_ai ... quota limit exceeded или периодические сообщения о лимите использования).
Сбои, не связанные с rate limit, завершаются ошибкой сразу; ротация ключей не выполняется.
Когда все ключи-кандидаты завершаются ошибкой, возвращается финальная ошибка последней попытки.

Официальные 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 все еще работают для совместимости.

Сотрудники Anthropic сообщили нам, что использование Claude CLI в стиле OpenClaw снова разрешено, поэтому OpenClaw считает повторное использование Claude CLI и использование claude -p санкционированными для этой интеграции, если Anthropic не опубликует новую политику. setup-token Anthropic остается доступным как поддерживаемый путь токена OpenClaw, но OpenClaw теперь предпочитает повторное использование Claude CLI и claude -p, когда они доступны.

{
  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-варианты в стиле подписки

Z.AI (GLM)

Coding Plan Z.AI или общие API endpoints.

MiniMax

OAuth MiniMax Coding Plan или доступ по API-ключу.

Qwen Cloud

Поверхность провайдера Qwen Cloud плюс сопоставление endpoint Alibaba DashScope и Coding Plan.

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 в OpenClaw — неофициальная интеграция. Некоторые пользователи сообщали об ограничениях аккаунта Google после использования сторонних клиентов. Ознакомьтесь с условиями Google и используйте некритичный аккаунт, если решите продолжить.

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

Установите Gemini CLI

brew
npm

brew install gemini-cli

npm install -g @google/gemini-cli

Включите Plugin

openclaw plugins enable google

Войдите

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

Модель по умолчанию: google-gemini-cli/gemini-3-flash-preview. Вы не вставляете идентификатор клиента или секрет в openclaw.json. Поток входа CLI сохраняет токены в профилях аутентификации на хосте Gateway.

Задайте проект (если нужно)

Если запросы завершаются с ошибкой после входа, задайте GOOGLE_CLOUD_PROJECT или GOOGLE_CLOUD_PROJECT_ID на хосте Gateway.

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 поставщиков

Поставщик	Идентификатор	Переменная окружения для аутентификации	Пример модели
BytePlus	`byteplus` / `byteplus-plan`	`BYTEPLUS_API_KEY`	`byteplus-plan/ark-code-latest`
Cohere	`cohere`	`COHERE_API_KEY`	`cohere/command-a-03-2025`
GitHub Copilot	`github-copilot`	`COPILOT_GITHUB_TOKEN` / `GH_TOKEN` / `GITHUB_TOKEN`	-
Hugging Face Inference	`huggingface`	`HUGGINGFACE_HUB_TOKEN` или `HF_TOKEN`	`huggingface/deepseek-ai/DeepSeek-R1`
MiniMax	`minimax` / `minimax-portal`	`MINIMAX_API_KEY` / `MINIMAX_OAUTH_TOKEN`	`minimax/MiniMax-M3`
Mistral	`mistral`	`MISTRAL_API_KEY`	`mistral/mistral-large-latest`
Moonshot	`moonshot`	`MOONSHOT_API_KEY`	`moonshot/kimi-k2.6`
NVIDIA	`nvidia`	`NVIDIA_API_KEY`	`nvidia/nvidia/nemotron-3-ultra-550b-a55b`
NovitaAI	`novita`	`NOVITA_API_KEY`	`novita/deepseek/deepseek-v3-0324`
Ollama Cloud	`ollama-cloud`	`OLLAMA_API_KEY`	`ollama-cloud/kimi-k2.6`
OpenRouter	`openrouter`	OpenRouter OAuth или `OPENROUTER_API_KEY`	`openrouter/auto`
Qwen OAuth	`qwen-oauth`	`QWEN_API_KEY`	`qwen-oauth/qwen3.5-plus`
Together	`together`	`TOGETHER_API_KEY`	`together/meta-llama/Llama-3.3-70B-Instruct-Turbo`
Venice	`venice`	`VENICE_API_KEY`	-
Vercel AI Gateway	`vercel-ai-gateway`	`AI_GATEWAY_API_KEY`	`vercel-ai-gateway/anthropic/claude-opus-4.6`
Volcano Engine (Doubao)	`volcengine` / `volcengine-plan`	`VOLCANO_ENGINE_API_KEY`	`volcengine-plan/ark-code-latest`
xAI	`xai`	SuperGrok/X Premium OAuth или `XAI_API_KEY`	`xai/grok-4.3`
Xiaomi	`xiaomi` / `xiaomi-token-plan`	`XIAOMI_API_KEY` / `XIAOMI_TOKEN_PLAN_API_KEY`	`xiaomi/mimo-v2-flash` / `xiaomi-token-plan/mimo-v2.5-pro`

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

OpenRouter

Применяет свои заголовки атрибуции приложения и маркеры Anthropic cache_control только на проверенных маршрутах openrouter.ai. Ссылки DeepSeek, Moonshot и ZAI подходят для кэширования подсказок с cache-TTL под управлением OpenRouter, но не получают маркеры кэша Anthropic. Как прокси-путь, совместимый с OpenAI, он пропускает формирование, предназначенное только для нативного OpenAI (serviceTier, Responses store, подсказки кэша подсказок, совместимость рассуждений OpenAI). Ссылки на базе Gemini сохраняют только очистку сигнатур мыслей proxy-Gemini.

Kilo Gateway

Ссылки на базе Gemini следуют тому же пути очистки proxy-Gemini; kilocode/kilo/auto и другие ссылки прокси без поддержки рассуждений пропускают внедрение прокси-рассуждений.

MiniMax

Онбординг с API-ключом записывает явные определения чат-моделей M3 и M2.7; понимание изображений остается на принадлежащем Plugin медиапоставщике MiniMax-VL-01.

NVIDIA

Идентификаторы моделей используют пространство имен nvidia/<vendor>/<model> (например, nvidia/nvidia/nemotron-... наряду с nvidia/moonshotai/kimi-k2.5); средства выбора сохраняют буквальную композицию <provider>/<model-id>, тогда как канонический ключ, отправляемый в API, остается с одним префиксом.

xAI

Использует путь xAI Responses. Рекомендуемый путь — SuperGrok/X Premium OAuth; API-ключи по-прежнему работают через XAI_API_KEY или конфигурацию Plugin, а Grok web_search повторно использует тот же профиль аутентификации перед резервным переходом к API-ключу. grok-4.3 — встроенная чат-модель по умолчанию, а grok-build-0.1 доступна для выбора для работы, ориентированной на сборку и кодирование. /fast или params.fastMode: true переписывает grok-3, grok-3-mini, grok-4 и grok-4-0709 в их варианты *-fast. tool_stream включен по умолчанию; отключите через agents.defaults.models["xai/<model>"].params.tool_stream=false.

Поставщики через `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 возвращается к нефильтрованному каталогу вместо показа пустого средства выбора, ограниченного провайдером.

Стандартные модели
Модели для программирования (volcengine-plan)

volcengine/doubao-seed-1-8-251228 (Doubao Seed 1.8)
volcengine/doubao-seed-code-preview-251028
volcengine/kimi-k2-5-260127 (Kimi K2.5)
volcengine/glm-4-7-251222 (GLM 4.7)
volcengine/deepseek-v3-2-251201 (DeepSeek V3.2 128K)

volcengine-plan/ark-code-latest
volcengine-plan/doubao-seed-code
volcengine-plan/kimi-k2.5
volcengine-plan/kimi-k2-thinking
volcengine-plan/glm-4.7

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 возвращается к нефильтрованному каталогу вместо показа пустого средства выбора, ограниченного провайдером.

Стандартные модели
Модели для программирования (byteplus-plan)

byteplus/seed-1-8-251228 (Seed 1.8)
byteplus/kimi-k2-5-260127 (Kimi K2.5)
byteplus/glm-4-7-251222 (GLM 4.7)

byteplus-plan/ark-code-latest
byteplus-plan/doubao-seed-code
byteplus-plan/kimi-k2.5
byteplus-plan/kimi-k2-thinking
byteplus-plan/glm-4.7

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, чтобы узнать подробности настройки, варианты моделей и фрагменты конфигурации.

На Anthropic-совместимом потоковом пути MiniMax OpenClaw по умолчанию отключает thinking для семейства M2.x, если вы явно не зададите его; MiniMax-M3 (и M3.x) по умолчанию остается на опущенном/адаптивном пути thinking провайдера. /fast on переписывает MiniMax-M2.7 в MiniMax-M2.7-highspeed.

Разделение возможностей, принадлежащее 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,
          },
        ],
      },
    },
  },
}

Необязательные поля по умолчанию

Для пользовательских провайдеров reasoning, input, cost, contextWindow и maxTokens необязательны. Если они опущены, OpenClaw по умолчанию использует:

reasoning: false
input: ["text"]
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }
contextWindow: 200000
maxTokens: 8192

Рекомендуется: задавайте явные значения, соответствующие ограничениям вашего прокси/модели.

Правила формирования прокси-маршрутов

Для api: "openai-completions" на ненативных конечных точках (любой непустой baseUrl, чей хост не является api.openai.com) OpenClaw принудительно устанавливает compat.supportsDeveloperRole: false, чтобы избежать ошибок 400 от провайдера для неподдерживаемых ролей developer.
Прокси-маршруты в стиле OpenAI-compatible также пропускают нативное формирование запросов, специфичное только для OpenAI: без service_tier, без Responses store, без Completions store, без подсказок prompt-cache, без формирования полезной нагрузки для совместимости reasoning OpenAI и без скрытых заголовков атрибуции OpenClaw.
Для OpenAI-compatible прокси Completions, которым нужны поля, специфичные для поставщика, задайте agents.defaults.models["provider/model"].params.extra_body (или extraBody), чтобы объединить дополнительный JSON с исходящим телом запроса.
Для элементов управления chat-template vLLM задайте agents.defaults.models["provider/model"].params.chat_template_kwargs. Встроенный Plugin vLLM автоматически отправляет enable_thinking: false и force_nonempty_content: true для vllm/nemotron-3-*, когда уровень thinking в сеансе отключен.
Для медленных локальных моделей или удаленных хостов LAN/tailnet задайте models.providers.<id>.timeoutSeconds. Это расширяет обработку HTTP-запросов модели провайдера, включая соединение, заголовки, потоковую передачу тела и общий guarded-fetch abort, не увеличивая тайм-аут всего выполнения агента. Если agents.defaults.timeoutSeconds или тайм-аут конкретного выполнения ниже, также увеличьте этот предел; тайм-ауты провайдера не могут продлить все выполнение.
HTTP-вызовы провайдера модели разрешают ответы fake-IP DNS от Surge, Clash и sing-box в 198.18.0.0/15 и fc00::/7 только для имени хоста настроенного baseUrl провайдера. Пользовательские/локальные конечные точки провайдера также доверяют точному настроенному источнику scheme://host:port для guarded-запросов модели, включая хосты loopback, LAN и tailnet. Это не новый параметр конфигурации; настроенный вами baseUrl расширяет политику запросов только для этого источника. Разрешение имени хоста fake-IP и доверие к точному источнику — независимые механизмы. Другие частные, loopback, link-local, metadata адреса назначения и другие порты по-прежнему требуют явного включения models.providers.<id>.request.allowPrivateNetwork: true. Задайте models.providers.<id>.request.allowPrivateNetwork: false, чтобы отказаться от доверия к точному источнику.
Если baseUrl пуст или опущен, OpenClaw сохраняет поведение OpenAI по умолчанию (которое разрешается в api.openai.com).
В целях безопасности явное compat.supportsDeveloperRole: true все равно переопределяется на ненативных конечных точках openai-completions.
Для api: "anthropic-messages" на непрямых конечных точках (любой провайдер, кроме канонического anthropic, или пользовательский models.providers.anthropic.baseUrl, чей хост не является публичной конечной точкой api.anthropic.com) OpenClaw подавляет неявные бета-заголовки Anthropic, такие как claude-code-20250219, interleaved-thinking-2025-05-14, и маркеры OAuth, чтобы пользовательские Anthropic-совместимые прокси не отклоняли неподдерживаемые бета-флаги. Явно задайте models.providers.<id>.headers["anthropic-beta"], если вашему прокси нужны конкретные бета-возможности.

Примеры CLI

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

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

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

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

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

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

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

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

​OpenAI

​Anthropic

​OpenAI ChatGPT/Codex OAuth

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

Z.AI (GLM)

MiniMax

Qwen Cloud

​OpenCode

​Google Gemini (API-ключ)

​Google Vertex и Gemini CLI

​Z.AI (GLM)

​Vercel AI Gateway

​Другие встроенные Plugin поставщиков

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

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

​Moonshot AI (Kimi)

​Написание кода с Kimi

​Volcano Engine (Doubao)

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

​Synthetic

​MiniMax

​LM Studio

​Ollama

​vLLM

​SGLang

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

​Примеры CLI

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

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

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

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

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

OpenAI

Anthropic

OpenAI ChatGPT/Codex OAuth

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

OpenCode

Google Gemini (API-ключ)

Google Vertex и Gemini CLI

Z.AI (GLM)

Vercel AI Gateway

Другие встроенные Plugin поставщиков

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

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

Moonshot AI (Kimi)

Написание кода с Kimi

Volcano Engine (Doubao)

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

Synthetic

MiniMax

LM Studio

Ollama

vLLM

SGLang

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

Примеры CLI

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