Постачальники моделей

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

Швидкі правила

Посилання на моделі та CLI-помічники

Посилання на моделі використовують 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 перевизначають їх для окремої моделі.
Правила резервного перемикання, перевірки cooldown і збереження перевизначень сесії: Відмовостійке перемикання моделей.

Додавання автентифікації постачальника не змінює вашу основну модель

openclaw configure зберігає наявний agents.defaults.model.primary, коли ви додаєте або повторно автентифікуєте постачальника. openclaw models auth login робить те саме, якщо не передати --set-default. Плагіни постачальників усе ще можуть повертати рекомендовану типову модель у своєму патчі конфігурації автентифікації, але OpenClaw трактує це як “зробити цю модель доступною”, якщо основна модель уже існує, а не як “замінити поточну основну модель”.Щоб навмисно перемкнути типову модель, використовуйте openclaw models set <provider/model> або openclaw models auth login --provider <id> --set-default.

Поділ постачальника/середовища виконання OpenAI

Маршрути сімейства OpenAI залежать від префікса:

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

Див. OpenAI і обв’язку Codex. Якщо поділ постачальника/середовища виконання незрозумілий, спочатку прочитайте середовища виконання агентів.Автоматичне ввімкнення плагіна дотримується тієї самої межі: посилання агентів openai/* вмикають плагін Codex для типового маршруту, а явні agentRuntime.id: "codex" на рівні постачальник/модель або застарілі посилання codex/<model> також потребують його.GPT-5.5 типово доступна через нативну обв’язку app-server Codex на openai/gpt-5.5, а через середовище виконання OpenClaw тоді, коли політика середовища виконання постачальник/модель явно вибирає openclaw.

CLI-середовища виконання

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

Поведінка постачальника, якою володіє Plugin

Більшість логіки, специфічної для постачальника, живе в плагінах постачальників (registerProvider(...)), тоді як OpenClaw зберігає загальний цикл інференсу. Плагіни відповідають за онбординг, каталоги моделей, зіставлення змінних середовища автентифікації, нормалізацію транспорту/конфігурації, очищення схем інструментів, класифікацію відмовостійкого перемикання, оновлення OAuth, звітування про використання, профілі thinking/reasoning тощо. Повний список хуків provider-SDK і приклади вбудованих плагінів наведено в плагінах постачальників. Постачальник, якому потрібен повністю власний виконавець запитів, є окремою, глибшою поверхнею розширення.

Поведінка runner, якою володіє постачальник, живе в явних хуках постачальника, як-от політика replay, нормалізація схем інструментів, обгортання потоку та помічники транспорту/запитів. Застарілий статичний контейнер ProviderPlugin.capabilities існує лише для сумісності й більше не читається спільною логікою runner.

Ротація API-ключів

Джерела ключів і пріоритет

Налаштуйте кілька ключів через:

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

Для постачальників Google GOOGLE_API_KEY також включено як fallback. Порядок вибору ключів зберігає пріоритет і видаляє дублікати значень.

Коли спрацьовує ротація

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

Офіційні плагіни постачальників

Офіційні плагіни постачальників публікують власні рядки каталогу моделей. Ці постачальники не потребують записів моделей 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 передає вибір транспорту спільному середовищу виконання моделей.
Перевизначайте для окремої моделі через 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 доступна через автентифікацію OAuth підписки ChatGPT/Codex, коли ваш обліковий запис після входу її відкриває; OpenClaw усе ще пригнічує прямі маршрути API-ключа OpenAI і API-ключа Azure для цієї моделі, бо ці транспорти її відхиляють

{
  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 бекенд окремо: anthropic/claude-opus-4-8 з 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
Посилання нативної обв’язки app-server Codex: openai/gpt-5.5
Документація нативної обв’язки app-server Codex: обв’язка Codex
Застарілі посилання на моделі: codex/gpt-*
Межа Plugin: openai/* завантажує Plugin OpenAI; нативний Plugin app-server Codex вибирається середовищем виконання обв’язки 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 використовує нативні contextWindow = 400000 з каталогу Codex і типове середовище виконання contextTokens = 272000; перевизначте обмеження середовища виконання через models.providers.openai.models[].contextTokens
Примітка щодо політики: OpenAI Codex OAuth явно підтримується для зовнішніх інструментів/робочих процесів, як-от OpenClaw.
Для типового маршруту підписки плюс нативного середовища виконання Codex увійдіть через автентифікацію openai і налаштуйте openai/gpt-5.5; ходи агента OpenAI типово вибирають Codex.
Використовуйте agentRuntime.id: "openclaw" на рівні постачальник/модель лише тоді, коли потрібен вбудований маршрут OpenClaw; інакше залишайте openai/gpt-5.5 на типовій обв’язці Codex.
застарілі посилання Codex GPT є застарілим станом, а не live-маршрутом постачальника. Використовуйте openai/gpt-5.5 у нативному середовищі виконання 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-ендпоїнти.

MiniMax

OAuth MiniMax Coding Plan або доступ через API-ключ.

Qwen Cloud

Поверхня постачальника Qwen Cloud плюс зіставлення ендпоїнтів Alibaba DashScope і Coding Plan.

OpenCode

Автентифікація: OPENCODE_API_KEY (або OPENCODE_ZEN_API_KEY)
Постачальник середовища виконання Zen: opencode
Постачальник середовища виконання 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 приймається й нормалізується до чинного ідентифікатора 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 відображаються як cacheRead OpenClaw

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`
ClawRouter	`clawrouter`	`CLAWROUTER_API_KEY`	`clawrouter/anthropic/claude-sonnet-4-6`
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, підказки prompt-cache, сумісність міркувань OpenAI). Посилання на базі Gemini зберігають лише санітизацію сигнатур думок proxy-Gemini.

Kilo Gateway

Посилання на базі Gemini проходять той самий шлях санітизації proxy-Gemini; kilocode/kilo/auto та інші посилання, що не підтримують проксі-міркування, пропускають ін’єкцію проксі-міркувань.

MiniMax

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

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` (користувацький/базовий URL)

Використовуйте models.providers (або models.json), щоб додати користувацьких провайдерів або OpenAI/Anthropic-сумісні проксі. Багато з наведених нижче вбудованих плагінів постачальників уже публікують стандартний каталог. Використовуйте явні записи models.providers.<id> лише тоді, коли потрібно перевизначити стандартний базовий URL, заголовки або список моделей. Перевірки можливостей моделей Gateway також читають явні метадані models.providers.<id>.models[]. Якщо користувацька або проксі-модель приймає зображення, задайте input: ["text", "image"] для цієї моделі, щоб WebChat і шляхи вкладень із джерелом Node передавали зображення як нативні вхідні дані моделі, а не як текстові посилання на медіа. 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/* реєструється одночасно. У засобах вибору моделей під час онбордингу/налаштування варіант автентифікації Volcengine надає перевагу рядкам volcengine/* і volcengine-plan/*. Якщо ці моделі ще не завантажено, OpenClaw повертається до нефільтрованого каталогу замість показу порожнього засобу вибору, обмеженого постачальником.

Standard models
Coding models (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" } },
  },
}

Онбординг за замовчуванням використовує поверхню для програмування, але загальний каталог byteplus/* реєструється одночасно. У засобах вибору моделей під час онбордингу/налаштування варіант автентифікації BytePlus надає перевагу рядкам byteplus/* і byteplus-plan/*. Якщо ці моделі ще не завантажено, OpenClaw повертається до нефільтрованого каталогу замість показу порожнього засобу вибору, обмеженого постачальником.

Standard models
Coding models (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 (глобальний): --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, щоб отримати подробиці налаштування, варіанти моделей і фрагменти конфігурації.

На 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 для онбордингу, хмарного/локального режиму та користувацької конфігурації.

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,
          },
        ],
      },
    },
  },
}

Default optional fields

Для користувацьких постачальників reasoning, input, cost, contextWindow і maxTokens є необов’язковими. Якщо їх пропущено, OpenClaw за замовчуванням використовує:

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

Рекомендовано: задайте явні значення, що відповідають обмеженням вашого проксі/моделі.

Proxy-route shaping rules

Для api: "openai-completions" на ненативних кінцевих точках (будь-яка непорожня baseUrl, хост якої не є api.openai.com) OpenClaw примусово задає compat.supportsDeveloperRole: false, щоб уникнути помилок 400 постачальника для непідтримуваних ролей developer.
OpenAI-сумісні маршрути проксі-стилю також пропускають формування запитів, властиве лише нативному OpenAI: без service_tier, без Responses store, без Completions store, без підказок prompt cache, без OpenAI reasoning-compat формування payload і без прихованих заголовків атрибуції OpenClaw.
Для OpenAI-сумісних проксі 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, не збільшуючи загальний тайм-аут часу виконання агента. Якщо agents.defaults.timeoutSeconds або тайм-аут конкретного запуску нижчий, підніміть і цю межу; тайм-аути постачальника не можуть подовжити весь запуск.
HTTP-виклики до постачальників моделей дозволяють fake-IP DNS-відповіді Surge, Clash і sing-box у 198.18.0.0/15 та fc00::/7 лише для імені хоста налаштованого baseUrl постачальника. Користувацькі/локальні кінцеві точки постачальника також довіряють точному налаштованому походженню scheme://host:port для захищених запитів моделей, включно з 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 пригнічує неявні beta-заголовки Anthropic, як-от claude-code-20250219, interleaved-thinking-2025-05-14 і OAuth-маркери, щоб користувацькі Anthropic-сумісні проксі не відхиляли непідтримувані beta-прапорці. Явно задайте models.providers.<id>.headers["anthropic-beta"], якщо вашому проксі потрібні конкретні beta-функції.

Приклади CLI

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

Див. також: Конфігурація для повних прикладів конфігурації.

Пов’язане

Довідник конфігурації - ключі конфігурації моделей
Відмовостійке перемикання моделей - ланцюжки fallback і поведінка повторних спроб
Моделі - конфігурація моделей і псевдоніми
Постачальники - посібники з налаштування для кожного постачальника

​Швидкі правила

​Поведінка постачальника, якою володіє Plugin

​Ротація API-ключів

​Офіційні плагіни постачальників

​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 (користувацький/базовий URL)

​Moonshot AI (Kimi)

​Кодування з Kimi

​Volcano Engine (Doubao)

​BytePlus (міжнародний)

​Synthetic

​MiniMax

​LM Studio

​Ollama

​vLLM

​SGLang

​Локальні проксі (LM Studio, vLLM, LiteLLM тощо)

​Приклади CLI

​Пов’язане

Швидкі правила

Поведінка постачальника, якою володіє Plugin

Ротація API-ключів

Офіційні плагіни постачальників

OpenAI

Anthropic

OpenAI ChatGPT/Codex OAuth

Інші hosted-варіанти в стилі підписки

OpenCode

Google Gemini (API-ключ)

Google Vertex і Gemini CLI

Z.AI (GLM)

Vercel AI Gateway

Інші вбудовані Plugin провайдерів

Особливості, які варто знати

Провайдери через `models.providers` (користувацький/базовий URL)

Moonshot AI (Kimi)

Кодування з Kimi

Volcano Engine (Doubao)

BytePlus (міжнародний)

Synthetic

MiniMax

LM Studio

Ollama

vLLM

SGLang

Локальні проксі (LM Studio, vLLM, LiteLLM тощо)

Приклади CLI

Пов’язане