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

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

Короткі правила

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

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

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

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

Вбудовані постачальники (каталог pi-ai)

OpenClaw постачається з каталогом pi-ai. Ці постачальники не потребують конфігурації 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 передає вибір транспорту до pi-ai.
• Перевизначення для окремої моделі через 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 навмисно приховано в OpenClaw, оскільки live-запити OpenAI API відхиляють його, а поточний каталог Codex не експонує його

{  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-7 з model-scoped agentRuntime.id: "claude-cli". Застарілі посилання claude-cli/claude-opus-4-7 усе ще працюють для сумісності.

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

OpenAI Codex OAuth

• Постачальник: openai-codex
• Автентифікація: OAuth (ChatGPT)
• Застаріле посилання на модель PI: openai-codex/gpt-5.5
• Посилання нативного harness сервера застосунку Codex: openai/gpt-5.5
• Документація нативного harness сервера застосунку Codex: harness Codex
• Застарілі посилання на моделі: codex/gpt-*
• Межа Plugin: openai-codex/* завантажує Plugin OpenAI; нативний Plugin сервера застосунку Codex вибирається лише runtime harness Codex або застарілими посиланнями codex/*.
• CLI: openclaw onboard --auth-choice openai-codex або openclaw models auth login --provider openai-codex
• Типовий транспорт — auto (спочатку WebSocket, SSE як fallback)
• Перевизначення для окремої моделі PI через agents.defaults.models["openai-codex/<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-codex/gpt-5.5 використовує нативні для каталогу Codex contextWindow = 400000 і типовий runtime contextTokens = 272000; перевизначте обмеження runtime за допомогою models.providers.openai-codex.models[].contextTokens
• Примітка щодо політики: OpenAI Codex OAuth явно підтримується для зовнішніх інструментів/робочих процесів, як-от OpenClaw.
• Для поширеного маршруту з підпискою плюс нативним runtime Codex увійдіть з автентифікацією openai-codex, але налаштуйте openai/gpt-5.5; кроки агента OpenAI типово вибирають Codex.
• Використовуйте provider/model agentRuntime.id: "pi" лише тоді, коли потрібен маршрут сумісності через PI; інакше залишайте openai/gpt-5.5 на типовому harness Codex.
• Старіші посилання openai-codex/gpt-5.1*, openai-codex/gpt-5.2* і openai-codex/gpt-5.3* приховано, оскільки облікові записи ChatGPT/Codex OAuth відхиляють їх; натомість використовуйте openai-codex/gpt-5.5 або нативний маршрут runtime Codex.

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

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

Інші розміщені варіанти в стилі підписки

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 приймається й нормалізується до live ID API Gemini від Google, google/gemini-3.1-pro-preview
• CLI: openclaw onboard --auth-choice gemini-api-key
• Мислення: /think adaptive використовує динамічне мислення Google. Gemini 3/3.1 не вказують фіксований thinkingLevel; Gemini 2.5 надсилає thinkingBudget: -1.
• Прямі запуски Gemini також приймають agents.defaults.models["google/<model>"].params.cachedContent (або застарілий cached_content), щоб передати нативний для провайдера дескриптор cachedContents/...; влучання кешу Gemini відображаються як OpenClaw cacheRead

Google Vertex і Gemini CLI

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

Gemini CLI OAuth постачається як частина вбудованого Plugin google.

brew install gemini-cli

npm install -g @google/gemini-cli

openclaw plugins enable google

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

Відповіді Gemini CLI JSON аналізуються з response; використання повертається до stats, а stats.cached нормалізується в OpenClaw cacheRead.

Z.AI (GLM)

• Провайдер: zai
• Автентифікація: ZAI_API_KEY
• Приклад моделі: zai/glm-5.1
• CLI: openclaw onboard --auth-choice zai-api-key
  • Псевдоніми: z.ai/* і z-ai/* нормалізуються до 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

Kilo Gateway

• Провайдер: kilocode
• Автентифікація: KILOCODE_API_KEY
• Приклад моделі: kilocode/kilo/auto
• CLI: openclaw onboard --auth-choice kilocode-api-key
• Базова URL-адреса: https://api.kilo.ai/api/gateway/
• Статичний резервний каталог постачає kilocode/kilo/auto; live-виявлення https://api.kilo.ai/api/gateway/models може додатково розширити каталог часу виконання.
• Точна upstream-маршрутизація за kilocode/kilo/auto належить Kilo Gateway, а не жорстко закодована в OpenClaw.

Див. /providers/kilocode, щоб отримати деталі налаштування.

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

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

Постачальники через models.providers (власна/базова URL-адреса)

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

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

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

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

Moonshot AI (Kimi)

Moonshot постачається як вбудований плагін постачальника. За замовчуванням використовуйте вбудованого постачальника й додавайте явний запис models.providers.moonshot лише тоді, коли потрібно перевизначити базову URL-адресу або метадані моделі:

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

ID моделей Kimi K2:

• moonshot/kimi-k2.6
• 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 coding

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

BytePlus (International)

BytePlus ARK надає міжнародним користувачам доступ до тих самих моделей, що й Volcano Engine.

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

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

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

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

Synthetic

Synthetic надає сумісні з Anthropic моделі через постачальника synthetic:

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

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

MiniMax

MiniMax налаштовується через models.providers, оскільки використовує власні кінцеві точки:

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

Див. /providers/minimax для подробиць налаштування, варіантів моделей і фрагментів конфігурації.

Розподіл можливостей, якими володіє Plugin:

• Типові налаштування тексту/чату залишаються на minimax/MiniMax-M2.7
• Генерація зображень — це 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,          },        ],      },    },  },}

Приклади CLI

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

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

Пов’язане

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