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

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

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

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

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

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

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

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

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

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

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 постачається як частина вбудованого Plugin google.

brew install gemini-cli

npm install -g @google/gemini-cli

openclaw plugins enable google

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

Gemini CLI за замовчуванням використовує stream-json. OpenClaw читає потокові повідомлення асистента й нормалізує stats.cached у cacheRead; застарілі перевизначення --output-format json досі читають текст відповіді з response.

Z.AI (GLM)

• Провайдер: zai
• Автентифікація: ZAI_API_KEY
• Приклад моделі: zai/glm-5.2
• CLI: openclaw onboard --auth-choice zai-api-key
  • Посилання на моделі використовують канонічний ідентифікатор провайдера zai/*.
  • zai-api-key автоматично визначає відповідну кінцеву точку Z.AI; zai-coding-global, zai-coding-cn, zai-global і zai-cn примусово задають конкретну поверхню

Vercel AI Gateway

• Провайдер: vercel-ai-gateway
• Автентифікація: AI_GATEWAY_API_KEY
• Приклади моделей: vercel-ai-gateway/anthropic/claude-opus-4.6, vercel-ai-gateway/moonshotai/kimi-k2.6
• CLI: openclaw onboard --auth-choice ai-gateway-api-key

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

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

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

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

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

Поділ можливостей, якими володіє 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,          },        ],      },    },  },}

Приклади CLI

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

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

Пов'язане

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