> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Поставщики моделей Справочник по **провайдерам LLM/моделей** (не чат-каналам вроде WhatsApp/Telegram). Правила выбора моделей см. в [Моделях](/ru/concepts/models). ## Быстрые правила * Ссылки на модели используют формат `provider/model` (пример: `opencode/claude-opus-4-6`). * `agents.defaults.models` при задании работает как список разрешенных моделей. * Вспомогательные команды CLI: `openclaw onboard`, `openclaw models list`, `openclaw models set `. * `models.providers.*.contextWindow` / `contextTokens` / `maxTokens` задают значения по умолчанию на уровне провайдера; `models.providers.*.models[].contextWindow` / `contextTokens` / `maxTokens` переопределяют их для каждой модели. * Правила fallback, проверки cooldown и сохранение переопределений сессии: [Отказоустойчивое переключение моделей](/ru/concepts/model-failover). `openclaw configure` сохраняет существующее значение `agents.defaults.model.primary`, когда вы добавляете или повторно авторизуете провайдера. `openclaw models auth login` делает то же самое, если не передать `--set-default`. Plugin провайдера все еще может вернуть рекомендуемую модель по умолчанию в патче конфигурации авторизации, но OpenClaw трактует это как «сделать эту модель доступной», если основная модель уже существует, а не как «заменить текущую основную модель». Чтобы намеренно переключить модель по умолчанию, используйте `openclaw models set ` или `openclaw models auth login --provider --set-default`. Маршруты семейства OpenAI зависят от префикса: * `openai/` по умолчанию использует нативный harness Codex app-server для ходов агента. Это обычная настройка подписки ChatGPT/Codex. * Устаревшие ссылки на модели Codex являются устаревшей конфигурацией, которую doctor переписывает в `openai/`. * `openai/` плюс провайдер/модель `agentRuntime.id: "openclaw"` использует встроенный runtime OpenClaw для явных маршрутов API-ключа или совместимости. См. [OpenAI](/ru/providers/openai) и [harness Codex](/ru/plugins/codex-harness). Если разделение провайдера и runtime непонятно, сначала прочитайте [runtime-ы агентов](/ru/concepts/agent-runtimes). Автовключение Plugin следует той же границе: ссылки агентов `openai/*` включают Plugin Codex для маршрута по умолчанию, а явные провайдер/модель `agentRuntime.id: "codex"` или устаревшие ссылки `codex/` также требуют его. GPT-5.5 по умолчанию доступна через нативный harness Codex app-server в `openai/gpt-5.5` и через runtime OpenClaw, когда политика runtime провайдера/модели явно выбирает `openclaw`. 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 провайдеров](/ru/plugins/sdk-provider-plugins). Провайдер, которому нужен полностью кастомный исполнитель запросов, является отдельной, более глубокой поверхностью расширения. Поведение runner, принадлежащее провайдеру, находится в явных hooks провайдера, таких как политика replay, нормализация схем инструментов, оборачивание stream и вспомогательные средства транспорта/запросов. Устаревший статический набор `ProviderPlugin.capabilities` существует только для совместимости и больше не читается общей логикой runner. ## Ротация API-ключей Настраивайте несколько ключей через: * `OPENCLAW_LIVE__KEY` (одиночное live-переопределение, самый высокий приоритет) * `_API_KEYS` (список через запятую или точку с запятой) * `_API_KEY` (основной ключ) * `_API_KEY_*` (нумерованный список, например `_API_KEY_1`) Для провайдеров Google `GOOGLE_API_KEY` также включается как fallback. Порядок выбора ключей сохраняет приоритет и удаляет дубликаты значений. * Запросы повторяются со следующим ключом только при ответах с 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/"].params.transport` (`"sse"`, `"websocket"` или `"auto"`) * Приоритетную обработку OpenAI можно включить через `agents.defaults.models["openai/"].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-ключа для этой модели, потому что эти транспорты ее отклоняют ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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`, когда они доступны. ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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](/ru/plugins/codex-harness) * Устаревшие ссылки на модели: `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/"].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/*`. ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { plugins: { entries: { codex: { enabled: true } } }, agents: { defaults: { model: { primary: "openai/gpt-5.5" }, }, }, } ``` ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { models: { providers: { openai: { models: [{ id: "gpt-5.5", contextTokens: 160000 }], }, }, }, } ``` ### Другие hosted-варианты в стиле подписки Coding Plan Z.AI или общие API endpoints. OAuth MiniMax Coding Plan или доступ по API-ключу. Поверхность провайдера 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` ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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/"].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`. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} brew install gemini-cli ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} npm install -g @google/gemini-cli ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw plugins enable google ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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](/ru/providers/ollama-cloud) | `ollama-cloud` | `OLLAMA_API_KEY` | `ollama-cloud/kimi-k2.6` | | OpenRouter | `openrouter` | OpenRouter OAuth или `OPENROUTER_API_KEY` | `openrouter/auto` | | [Qwen OAuth](/ru/providers/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` | #### Особенности, о которых стоит знать Применяет свои заголовки атрибуции приложения и маркеры Anthropic `cache_control` только на проверенных маршрутах `openrouter.ai`. Ссылки DeepSeek, Moonshot и ZAI подходят для кэширования подсказок с cache-TTL под управлением OpenRouter, но не получают маркеры кэша Anthropic. Как прокси-путь, совместимый с OpenAI, он пропускает формирование, предназначенное только для нативного OpenAI (`serviceTier`, Responses `store`, подсказки кэша подсказок, совместимость рассуждений OpenAI). Ссылки на базе Gemini сохраняют только очистку сигнатур мыслей proxy-Gemini. Ссылки на базе Gemini следуют тому же пути очистки proxy-Gemini; `kilocode/kilo/auto` и другие ссылки прокси без поддержки рассуждений пропускают внедрение прокси-рассуждений. Онбординг с API-ключом записывает явные определения чат-моделей M3 и M2.7; понимание изображений остается на принадлежащем Plugin медиапоставщике `MiniMax-VL-01`. Идентификаторы моделей используют пространство имен `nvidia//` (например, `nvidia/nvidia/nemotron-...` наряду с `nvidia/moonshotai/kimi-k2.5`); средства выбора сохраняют буквальную композицию `/`, тогда как канонический ключ, отправляемый в API, остается с одним префиксом. Использует путь 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/"].params.tool_stream=false`. ## Поставщики через `models.providers` (пользовательский/base URL) Используйте `models.providers` (или `models.json`), чтобы добавить **пользовательских** поставщиков или прокси, совместимые с OpenAI/Anthropic. Многие из встроенных Plugin поставщиков ниже уже публикуют каталог по умолчанию. Используйте явные записи `models.providers.` только когда хотите переопределить базовый URL по умолчанию, заголовки или список моделей. Проверки возможностей моделей Gateway также читают явные метаданные `models.providers..models[]`. Если пользовательская или прокси-модель принимает изображения, задайте `input: ["text", "image"]` для этой модели, чтобы WebChat и пути вложений, исходящих из узлов, передавали изображения как нативные входные данные модели, а не как текстовые ссылки на медиа. `agents.defaults.models["provider/model"]` управляет только видимостью модели, псевдонимами и метаданными отдельных моделей для агентов. Сам по себе он не регистрирует новую модель времени выполнения. Для пользовательских моделей провайдера также добавьте `models.providers..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-model-refs:start" * `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` [//]: # "moonshot-kimi-k2-model-refs:end" ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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` ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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` ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { agents: { defaults: { model: { primary: "volcengine-plan/ark-code-latest" } }, }, } ``` Онбординг по умолчанию использует поверхность для написания кода, но общий каталог `volcengine/*` регистрируется одновременно. В средствах выбора модели для onboarding/configure вариант аутентификации Volcengine предпочитает строки как `volcengine/*`, так и `volcengine-plan/*`. Если эти модели еще не загружены, OpenClaw возвращается к нефильтрованному каталогу вместо показа пустого средства выбора, ограниченного провайдером. * `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` ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { agents: { defaults: { model: { primary: "byteplus-plan/ark-code-latest" } }, }, } ``` Onboarding по умолчанию использует поверхность для программирования, но общий каталог `byteplus/*` регистрируется одновременно. В средствах выбора модели для onboarding/configure вариант аутентификации BytePlus предпочитает строки как `byteplus/*`, так и `byteplus-plan/*`. Если эти модели еще не загружены, OpenClaw возвращается к нефильтрованному каталогу вместо показа пустого средства выбора, ограниченного провайдером. * `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` ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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](/ru/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`): ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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](/ru/providers/lmstudio) для настройки и устранения неполадок. ### Ollama Ollama поставляется как встроенный Plugin провайдера и использует нативный API Ollama: * Провайдер: `ollama` * Аутентификация: не требуется (локальный сервер) * Пример модели: `ollama/llama3.3` * Установка: [https://ollama.com/download](https://ollama.com/download) ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # Install Ollama, then pull a model: ollama pull llama3.3 ``` ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { agents: { defaults: { model: { primary: "ollama/llama3.3" } }, }, } ``` Ollama обнаруживается локально по адресу `http://127.0.0.1:11434`, когда вы явно включаете ее с помощью `OLLAMA_API_KEY`, а встроенный Plugin провайдера добавляет Ollama напрямую в `openclaw onboard` и средство выбора модели. См. [/providers/ollama](/ru/providers/ollama) для onboarding, облачного/локального режима и пользовательской конфигурации. ### vLLM vLLM поставляется как встроенный Plugin провайдера для локальных/самостоятельно размещенных OpenAI-совместимых серверов: * Провайдер: `vllm` * Аутентификация: необязательно (зависит от вашего сервера) * Базовый URL по умолчанию: `http://127.0.0.1:8000/v1` Чтобы локально включить автообнаружение (подойдет любое значение, если ваш сервер не требует аутентификации): ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} export VLLM_API_KEY="vllm-local" ``` Затем задайте модель (замените на один из идентификаторов, возвращаемых `/v1/models`): ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { agents: { defaults: { model: { primary: "vllm/your-model-id" } }, }, } ``` См. [/providers/vllm](/ru/providers/vllm) для подробностей. ### SGLang SGLang поставляется как встроенный Plugin провайдера для быстрых самостоятельно размещенных OpenAI-совместимых серверов: * Провайдер: `sglang` * Аутентификация: необязательно (зависит от вашего сервера) * Базовый URL по умолчанию: `http://127.0.0.1:30000/v1` Чтобы локально включить автообнаружение (подойдет любое значение, если ваш сервер не требует аутентификации): ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} export SGLANG_API_KEY="sglang-local" ``` Затем задайте модель (замените на один из идентификаторов, возвращаемых `/v1/models`): ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { agents: { defaults: { model: { primary: "sglang/your-model-id" } }, }, } ``` См. [/providers/sglang](/ru/providers/sglang) для подробностей. ### Локальные прокси (LM Studio, vLLM, LiteLLM и т. д.) Пример (OpenAI-совместимый): ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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..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..request.allowPrivateNetwork: true`. Задайте `models.providers..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..headers["anthropic-beta"]`, если вашему прокси нужны конкретные бета-возможности. ## Примеры CLI ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --auth-choice opencode-zen openclaw models set opencode/claude-opus-4-6 openclaw models list ``` См. также: [Конфигурация](/ru/gateway/configuration) для полных примеров конфигурации. ## Смежные разделы * [Справочник по конфигурации](/ru/gateway/config-agents#agent-defaults) - ключи конфигурации моделей * [Отказоустойчивое переключение моделей](/ru/concepts/model-failover) - цепочки резервного переключения и поведение повторных попыток * [Модели](/ru/concepts/models) - конфигурация моделей и псевдонимы * [Провайдеры](/ru/providers) - руководства по настройке для каждого провайдера