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

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

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

# Поведінка провайдера, якою володіє Plugin

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

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

# Ротація 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
• Типовий transport — auto (спочатку WebSocket, fallback на SSE)
• Перевизначайте для окремої моделі через agents.defaults.models["openai/<model>"].params.transport ("sse", "websocket" або "auto")
• Прогрівання OpenAI Responses WebSocket типово ввімкнене через params.openaiWsWarmup (true/false)
• Пріоритетну обробку 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 навмисно придушено в 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 з agents.defaults.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
• Посилання на нативний app-server harness Codex: openai/gpt-5.5 з agents.defaults.agentRuntime.id: "codex"
• Документація нативного app-server harness Codex: Codex harness
• Застарілі посилання на моделі: codex/gpt-*
• Межа Plugin: openai-codex/* завантажує OpenAI plugin; нативний app-server plugin Codex вибирається лише через runtime Codex harness або застарілі посилання codex/*.
• CLI: openclaw onboard --auth-choice openai-codex або openclaw models auth login --provider openai-codex
• Типовий transport — auto (спочатку WebSocket, fallback на SSE)
• Перевизначайте для окремої моделі 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 плюс agents.defaults.agentRuntime.id: "codex".
• Використовуйте openai-codex/gpt-5.5 лише тоді, коли потрібен маршрут Codex OAuth/підписки через PI; використовуйте openai/gpt-5.5 без перевизначення runtime Codex, коли ваше налаштування API-ключа й локальний каталог надають публічний API-маршрут.
• Старіші посилання 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" },
      agentRuntime: { id: "codex" },
    },
  },
}

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

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

# OpenCode

• Автентифікація: OPENCODE_API_KEY (або OPENCODE_ZEN_API_KEY)
• Провайдер Zen runtime: opencode
• Провайдер Go runtime: opencode-go
• Приклади моделей: opencode/claude-opus-4-6, opencode-go/kimi-k2.6
• CLI: openclaw onboard --auth-choice opencode-zen або openclaw onboard --auth-choice opencode-go

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

# Google Gemini (API-ключ)

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

JSON-відповіді Gemini CLI аналізуються з 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; живе виявлення https://api.kilo.ai/api/gateway/models може додатково розширити каталог часу виконання.
• Точна upstream-маршрутизація за kilocode/kilo/auto належить Kilo Gateway, а не жорстко закодована в OpenClaw.

Докладні відомості про налаштування див. у /providers/kilocode.

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

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

# Провайдери через models.providers (власний/base URL)

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

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

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

# Moonshot AI (Kimi)

Moonshot постачається як комплектний Plugin провайдера. За замовчуванням використовуйте вбудованого провайдера й додавайте явний запис 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

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

Kimi Coding використовує Anthropic-сумісну кінцеву точку Moonshot AI:

• Провайдер: kimi
• Автентифікація: KIMI_API_KEY
• Приклад моделі: kimi/kimi-code

{
  env: { KIMI_API_KEY: "sk-..." },
  agents: {
    defaults: { model: { primary: "kimi/kimi-code" } },
  },
}

Застарілий kimi/k2p5 досі приймається як сумісний id моделі.

# 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" } },
  },
}

Onboarding за замовчуванням використовує поверхню для кодування, але загальний каталог volcengine/* реєструється одночасно.

У засобах вибору моделі під час onboarding/configure вибір автентифікації 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" } },
  },
}

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

У засобах вибору моделі під час onboarding/configure вибір автентифікації 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 (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 для подробиць налаштування, варіантів моделей і фрагментів конфігурації.

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

• Текстові/чатові значення за замовчуванням залишаються на minimax/MiniMax-M2.7
• Генерація зображень — це minimax/image-01 або minimax-portal/image-01
• Розуміння зображень належить Plugin: MiniMax-VL-01 на обох шляхах автентифікації MiniMax
• Вебпошук залишається на id провайдера minimax

# LM Studio

LM Studio постачається як вбудований Plugin провайдера, що використовує нативний API:

• Провайдер: lmstudio
• Автентифікація: LM_API_TOKEN
• Базовий URL інференсу за замовчуванням: http://localhost:1234/v1

Потім задайте модель (замініть одним з ID, які повертає http://localhost:1234/api/v1/models):

{
  agents: {
    defaults: { model: { primary: "lmstudio/openai/gpt-oss-20b" } },
  },
}

OpenClaw використовує нативні /api/v1/models і /api/v1/models/load LM Studio для виявлення та автозавантаження, а /v1/chat/completions для інференсу за замовчуванням. Якщо ви хочете, щоб JIT-завантаження, TTL і автоматичне витіснення LM Studio керували життєвим циклом моделі, задайте models.providers.lmstudio.params.preload: false. Див. /providers/lmstudio для налаштування й усунення несправностей.

# Ollama

Ollama постачається як вбудований Plugin провайдера та використовує нативний API Ollama:

• Провайдер: ollama
• Автентифікація: не потрібна (локальний сервер)
• Приклад моделі: ollama/llama3.3
• Встановлення: https://ollama.com/download

# Install Ollama, then pull a model:
ollama pull llama3.3

{
  agents: {
    defaults: { model: { primary: "ollama/llama3.3" } },
  },
}

Ollama виявляється локально за адресою http://127.0.0.1:11434, коли ви вмикаєте її через OLLAMA_API_KEY, а вбудований Plugin провайдера додає Ollama безпосередньо до openclaw onboard і засобу вибору моделі. Див. /providers/ollama для onboarding, хмарного/локального режиму та власної конфігурації.

# vLLM

vLLM постачається як вбудований Plugin провайдера для локальних/самостійно розгорнутих OpenAI-сумісних серверів:

• Провайдер: vllm
• Автентифікація: необов’язкова (залежить від вашого сервера)
• Базовий URL за замовчуванням: http://127.0.0.1:8000/v1

Щоб увімкнути локальне автовиявлення (будь-яке значення працює, якщо ваш сервер не вимагає автентифікації):

export VLLM_API_KEY="vllm-local"

Потім задайте модель (замініть одним з ID, які повертає /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"

Потім задайте модель (замініть одним з ID, які повертає /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-zen
openclaw models set opencode/claude-opus-4-6
openclaw models list

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

# Пов’язане

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