Dostawcy modeli

Odniesienie dla dostawców LLM/modeli (nie kanałów czatu takich jak WhatsApp/Telegram). Zasady wyboru modeli znajdziesz w Modele.

Szybkie zasady

Zachowanie dostawców należące do Pluginów

Większość logiki specyficznej dla dostawcy znajduje się w Pluginach dostawców (registerProvider(...)), podczas gdy OpenClaw utrzymuje ogólną pętlę wnioskowania. Pluginy odpowiadają za wdrażanie, katalogi modeli, mapowanie zmiennych środowiskowych uwierzytelniania, normalizację transportu/konfiguracji, czyszczenie schematów narzędzi, klasyfikację awaryjnego przełączania, odświeżanie OAuth, raportowanie użycia, profile myślenia/rozumowania i więcej.

Pełna lista hooków provider-SDK i przykładów dołączonych Pluginów znajduje się w Pluginy dostawców. Dostawca, który potrzebuje całkowicie niestandardowego wykonawcy żądań, korzysta z osobnej, głębszej powierzchni rozszerzeń.

Rotacja kluczy API

Wbudowani dostawcy (katalog pi-ai)

OpenClaw jest dostarczany z katalogiem pi-ai. Ci dostawcy nie wymagają konfiguracji models.providers; wystarczy ustawić uwierzytelnianie i wybrać model.

OpenAI

• Dostawca: openai
• Uwierzytelnianie: OPENAI_API_KEY
• Opcjonalna rotacja: OPENAI_API_KEYS, OPENAI_API_KEY_1, OPENAI_API_KEY_2 oraz OPENCLAW_LIVE_OPENAI_KEY (pojedyncze nadpisanie)
• Przykładowe modele: openai/gpt-5.5, openai/gpt-5.4-mini
• Zweryfikuj dostępność konta/modelu za pomocą openclaw models list --provider openai, jeśli konkretna instalacja lub klucz API zachowuje się inaczej.
• CLI: openclaw onboard --auth-choice openai-api-key
• Domyślny transport to auto; OpenClaw przekazuje wybór transportu do pi-ai.
• Nadpisz dla danego modelu przez agents.defaults.models["openai/<model>"].params.transport ("sse", "websocket" lub "auto")
• Przetwarzanie priorytetowe OpenAI można włączyć przez agents.defaults.models["openai/<model>"].params.serviceTier
• /fast i params.fastMode mapują bezpośrednie żądania Responses openai/* na service_tier=priority na api.openai.com
• Użyj params.serviceTier, gdy chcesz jawny poziom zamiast współdzielonego przełącznika /fast
• Ukryte nagłówki atrybucji OpenClaw (originator, version, User-Agent) mają zastosowanie tylko do natywnego ruchu OpenAI do api.openai.com, a nie do ogólnych proxy zgodnych z OpenAI
• Natywne trasy OpenAI zachowują także store Responses, wskazówki pamięci podręcznej promptów oraz kształtowanie ładunku zgodne z rozumowaniem OpenAI; trasy proxy tego nie robią
• openai/gpt-5.3-codex-spark jest celowo pomijany w OpenClaw, ponieważ żądania live do API OpenAI go odrzucają, a bieżący katalog Codex go nie udostępnia

{  agents: { defaults: { model: { primary: "openai/gpt-5.5" } } },}

Anthropic

• Dostawca: anthropic
• Uwierzytelnianie: ANTHROPIC_API_KEY
• Opcjonalna rotacja: ANTHROPIC_API_KEYS, ANTHROPIC_API_KEY_1, ANTHROPIC_API_KEY_2 oraz OPENCLAW_LIVE_ANTHROPIC_KEY (pojedyncze nadpisanie)
• Przykładowy model: anthropic/claude-opus-4-6
• CLI: openclaw onboard --auth-choice apiKey
• Bezpośrednie publiczne żądania Anthropic obsługują współdzielony przełącznik /fast i params.fastMode, w tym ruch z kluczem API i uwierzytelniony przez OAuth wysyłany do api.anthropic.com; OpenClaw mapuje to na Anthropic service_tier (auto vs standard_only)
• Preferowana konfiguracja Claude CLI zachowuje kanoniczną referencję modelu i wybiera backend CLI osobno: anthropic/claude-opus-4-7 z modelowym agentRuntime.id: "claude-cli". Starsze referencje claude-cli/claude-opus-4-7 nadal działają dla zgodności.

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

OAuth OpenAI Codex

• Dostawca: openai-codex
• Uwierzytelnianie: OAuth (ChatGPT)
• Starsza referencja modelu PI: openai-codex/gpt-5.5
• Natywna referencja app-server harness Codex: openai/gpt-5.5
• Dokumentacja natywnego app-server harness Codex: Codex harness
• Starsze referencje modeli: codex/gpt-*
• Granica Pluginu: openai-codex/* ładuje Plugin OpenAI; natywny Plugin app-server Codex jest wybierany tylko przez środowisko uruchomieniowe Codex harness albo starsze referencje codex/*.
• CLI: openclaw onboard --auth-choice openai-codex albo openclaw models auth login --provider openai-codex
• Domyślny transport to auto (najpierw WebSocket, fallback do SSE)
• Nadpisz dla danego modelu PI przez agents.defaults.models["openai-codex/<model>"].params.transport ("sse", "websocket" lub "auto")
• params.serviceTier jest także przekazywane w natywnych żądaniach Responses Codex (chatgpt.com/backend-api)
• Ukryte nagłówki atrybucji OpenClaw (originator, version, User-Agent) są dołączane tylko do natywnego ruchu Codex do chatgpt.com/backend-api, a nie do ogólnych proxy zgodnych z OpenAI
• Współdzieli tę samą konfigurację przełącznika /fast i params.fastMode co bezpośrednie openai/*; OpenClaw mapuje to na service_tier=priority
• openai-codex/gpt-5.5 używa natywnego contextWindow = 400000 z katalogu Codex i domyślnego runtime contextTokens = 272000; nadpisz limit runtime przez models.providers.openai-codex.models[].contextTokens
• Uwaga dotycząca polityki: OAuth OpenAI Codex jest jawnie obsługiwany dla zewnętrznych narzędzi/przepływów pracy, takich jak OpenClaw.
• Dla typowej trasy subskrypcji plus natywnego środowiska uruchomieniowego Codex zaloguj się uwierzytelnianiem openai-codex, ale skonfiguruj openai/gpt-5.5; tury agenta OpenAI domyślnie wybierają Codex.
• Użyj agentRuntime.id: "pi" dostawcy/modelu tylko wtedy, gdy chcesz trasę zgodności przez PI; w przeciwnym razie pozostaw openai/gpt-5.5 na domyślnym Codex harness.
• Starsze referencje openai-codex/gpt-5.1*, openai-codex/gpt-5.2* i openai-codex/gpt-5.3* są pomijane, ponieważ konta OAuth ChatGPT/Codex je odrzucają; zamiast tego użyj openai-codex/gpt-5.5 albo natywnej trasy środowiska uruchomieniowego 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 }],      },    },  },}

Inne hostowane opcje w stylu subskrypcji

OpenCode

• Uwierzytelnianie: OPENCODE_API_KEY (albo OPENCODE_ZEN_API_KEY)
• Dostawca środowiska uruchomieniowego Zen: opencode
• Dostawca środowiska uruchomieniowego Go: opencode-go
• Przykładowe modele: opencode/claude-opus-4-6, opencode-go/kimi-k2.6
• CLI: openclaw onboard --auth-choice opencode-zen albo openclaw onboard --auth-choice opencode-go

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

Google Gemini (klucz API)

• Dostawca: google
• Uwierzytelnianie: GEMINI_API_KEY
• Opcjonalna rotacja: GEMINI_API_KEYS, GEMINI_API_KEY_1, GEMINI_API_KEY_2, awaryjne użycie GOOGLE_API_KEY oraz OPENCLAW_LIVE_GEMINI_KEY (pojedyncze nadpisanie)
• Przykładowe modele: google/gemini-3.1-pro-preview, google/gemini-3-flash-preview
• Zgodność: starsza konfiguracja OpenClaw używająca google/gemini-3.1-flash-preview jest normalizowana do google/gemini-3-flash-preview
• Alias: google/gemini-3.1-pro jest akceptowany i normalizowany do aktywnego identyfikatora Google Gemini API, google/gemini-3.1-pro-preview
• CLI: openclaw onboard --auth-choice gemini-api-key
• Myślenie: /think adaptive używa dynamicznego myślenia Google. Gemini 3/3.1 pomijają stały thinkingLevel; Gemini 2.5 wysyła thinkingBudget: -1.
• Bezpośrednie uruchomienia Gemini akceptują także agents.defaults.models["google/<model>"].params.cachedContent (lub starsze cached_content) w celu przekazania natywnego dla dostawcy uchwytu cachedContents/...; trafienia w pamięć podręczną Gemini pojawiają się jako OpenClaw cacheRead

Google Vertex i Gemini CLI

• Dostawcy: google-vertex, google-gemini-cli
• Uwierzytelnianie: Vertex używa gcloud ADC; Gemini CLI używa własnego przepływu OAuth

Gemini CLI OAuth jest dostarczany jako część dołączonego 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

Odpowiedzi JSON Gemini CLI są parsowane z response; użycie awaryjnie korzysta ze stats, a stats.cached jest normalizowane do OpenClaw cacheRead.

Z.AI (GLM)

• Dostawca: zai
• Uwierzytelnianie: ZAI_API_KEY
• Przykładowy model: zai/glm-5.1
• CLI: openclaw onboard --auth-choice zai-api-key
  • Aliasy: z.ai/* i z-ai/* normalizują się do zai/*
  • zai-api-key automatycznie wykrywa pasujący punkt końcowy Z.AI; zai-coding-global, zai-coding-cn, zai-global i zai-cn wymuszają konkretną powierzchnię

Vercel AI Gateway

• Dostawca: vercel-ai-gateway
• Uwierzytelnianie: AI_GATEWAY_API_KEY
• Przykładowe modele: 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

• Dostawca: kilocode
• Uwierzytelnianie: KILOCODE_API_KEY
• Przykładowy model: kilocode/kilo/auto
• CLI: openclaw onboard --auth-choice kilocode-api-key
• Bazowy URL: https://api.kilo.ai/api/gateway/
• Statyczny katalog awaryjny dostarcza kilocode/kilo/auto; wykrywanie na żywo https://api.kilo.ai/api/gateway/models może dodatkowo rozszerzyć katalog środowiska uruchomieniowego.
• Dokładny routing upstream za kilocode/kilo/auto należy do Kilo Gateway, nie jest zakodowany na stałe w OpenClaw.

Zobacz /providers/kilocode, aby uzyskać szczegóły konfiguracji.

Inne dołączone Plugin dostawców

Niuanse, które warto znać

Dostawcy przez models.providers (niestandardowy/bazowy URL)

Użyj models.providers (lub models.json), aby dodać niestandardowych dostawców albo proxy zgodne z OpenAI/Anthropic.

Wiele poniższych dołączonych pluginów dostawców publikuje już domyślny katalog. Używaj jawnych wpisów models.providers.<id> tylko wtedy, gdy chcesz nadpisać domyślny bazowy URL, nagłówki lub listę modeli.

Kontrole możliwości modeli Gateway odczytują także jawne metadane models.providers.<id>.models[]. Jeśli model niestandardowy lub proxy akceptuje obrazy, ustaw input: ["text", "image"] dla tego modelu, aby WebChat i ścieżki załączników pochodzące z węzła przekazywały obrazy jako natywne dane wejściowe modelu zamiast tekstowych referencji mediów.

agents.defaults.models["provider/model"] kontroluje tylko widoczność modelu, aliasy i metadane poszczególnych modeli dla agentów. Samo w sobie nie rejestruje nowego modelu runtime. Dla niestandardowych modeli dostawców dodaj także models.providers.<provider>.models[] z co najmniej pasującym id.

Moonshot AI (Kimi)

Moonshot jest dostarczany jako dołączony Plugin dostawcy. Domyślnie używaj wbudowanego dostawcy i dodawaj jawny wpis models.providers.moonshot tylko wtedy, gdy musisz nadpisać bazowy URL lub metadane modelu:

• Dostawca: moonshot
• Uwierzytelnianie: MOONSHOT_API_KEY
• Przykładowy model: moonshot/kimi-k2.6
• CLI: openclaw onboard --auth-choice moonshot-api-key lub openclaw onboard --auth-choice moonshot-api-key-cn

Identyfikatory modeli 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" }],      },    },  },}

Kodowanie Kimi

Kimi Coding używa punktu końcowego zgodnego z Anthropic od Moonshot AI:

• Dostawca: kimi
• Uwierzytelnianie: KIMI_API_KEY
• Przykładowy model: kimi/kimi-for-coding

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

Starsze kimi/kimi-code i kimi/k2p5 pozostają akceptowane jako identyfikatory modeli zgodności i są normalizowane do stabilnego identyfikatora modelu API Kimi.

Volcano Engine (Doubao)

Volcano Engine (火山引擎) zapewnia dostęp do Doubao i innych modeli w Chinach.

• Dostawca: volcengine (kodowanie: volcengine-plan)
• Uwierzytelnianie: VOLCANO_ENGINE_API_KEY
• Przykładowy model: volcengine-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice volcengine-api-key

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

Onboarding domyślnie używa powierzchni kodowania, ale ogólny katalog volcengine/* jest rejestrowany w tym samym czasie.

W selektorach modeli onboardingu/konfiguracji wybór uwierzytelniania Volcengine preferuje wiersze volcengine/* i volcengine-plan/*. Jeśli te modele nie są jeszcze załadowane, OpenClaw wraca do niefiltrowanego katalogu zamiast pokazywać pusty selektor ograniczony do dostawcy.

BytePlus (międzynarodowy)

BytePlus ARK zapewnia użytkownikom międzynarodowym dostęp do tych samych modeli co Volcano Engine.

• Dostawca: byteplus (kodowanie: byteplus-plan)
• Uwierzytelnianie: BYTEPLUS_API_KEY
• Przykładowy model: byteplus-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice byteplus-api-key

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

Onboarding domyślnie używa powierzchni kodowania, ale ogólny katalog byteplus/* jest rejestrowany w tym samym czasie.

W selektorach modeli onboardingu/konfiguracji wybór uwierzytelniania BytePlus preferuje wiersze byteplus/* i byteplus-plan/*. Jeśli te modele nie są jeszcze załadowane, OpenClaw wraca do niefiltrowanego katalogu zamiast pokazywać pusty selektor ograniczony do dostawcy.

Synthetic

Synthetic zapewnia modele zgodne z Anthropic za dostawcą synthetic:

• Dostawca: synthetic
• Uwierzytelnianie: SYNTHETIC_API_KEY
• Przykładowy model: 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 jest konfigurowany przez models.providers, ponieważ używa niestandardowych punktów końcowych:

• MiniMax OAuth (globalny): --auth-choice minimax-global-oauth
• MiniMax OAuth (CN): --auth-choice minimax-cn-oauth
• Klucz API MiniMax (globalny): --auth-choice minimax-global-api
• Klucz API MiniMax (CN): --auth-choice minimax-cn-api
• Uwierzytelnianie: MINIMAX_API_KEY dla minimax; MINIMAX_OAUTH_TOKEN lub MINIMAX_API_KEY dla minimax-portal

Zobacz /providers/minimax, aby poznać szczegóły konfiguracji, opcje modeli i fragmenty konfiguracji.

Podział możliwości należących do Pluginu:

• Domyślne ustawienia tekstu/czatu pozostają na minimax/MiniMax-M2.7
• Generowanie obrazów to minimax/image-01 lub minimax-portal/image-01
• Rozumienie obrazów należy do Pluginu MiniMax-VL-01 na obu ścieżkach uwierzytelniania MiniMax
• Wyszukiwanie w sieci pozostaje na identyfikatorze dostawcy minimax

LM Studio

LM Studio jest dostarczane jako dołączony Plugin dostawcy, który używa natywnego API:

• Dostawca: lmstudio
• Uwierzytelnianie: LM_API_TOKEN
• Domyślny bazowy URL inferencji: http://localhost:1234/v1

Następnie ustaw model (zastąp jednym z identyfikatorów zwracanych przez http://localhost:1234/api/v1/models):

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

OpenClaw używa natywnych /api/v1/models i /api/v1/models/load LM Studio do wykrywania i automatycznego ładowania, a domyślnie /v1/chat/completions do inferencji. Jeśli chcesz, aby ładowanie JIT, TTL i automatyczne usuwanie LM Studio zarządzały cyklem życia modelu, ustaw models.providers.lmstudio.params.preload: false. Zobacz /providers/lmstudio, aby poznać konfigurację i rozwiązywanie problemów.

Ollama

Ollama jest dostarczana jako dołączony Plugin dostawcy i używa natywnego API Ollama:

• Dostawca: ollama
• Uwierzytelnianie: nie jest wymagane (serwer lokalny)
• Przykładowy model: ollama/llama3.3
• Instalacja: https://ollama.com/download

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

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

Ollama jest wykrywana lokalnie pod http://127.0.0.1:11434, gdy włączysz ją przez OLLAMA_API_KEY, a dołączony Plugin dostawcy dodaje Ollama bezpośrednio do openclaw onboard i selektora modeli. Zobacz /providers/ollama, aby poznać onboarding, tryb chmurowy/lokalny i konfigurację niestandardową.

vLLM

vLLM jest dostarczany jako dołączony Plugin dostawcy dla lokalnych/samodzielnie hostowanych serwerów zgodnych z OpenAI:

• Dostawca: vllm
• Uwierzytelnianie: opcjonalne (zależy od serwera)
• Domyślny bazowy URL: http://127.0.0.1:8000/v1

Aby włączyć lokalne automatyczne wykrywanie (dowolna wartość działa, jeśli serwer nie wymusza uwierzytelniania):

export VLLM_API_KEY="vllm-local"

Następnie ustaw model (zastąp jednym z identyfikatorów zwracanych przez /v1/models):

{  agents: {    defaults: { model: { primary: "vllm/your-model-id" } },  },}

Zobacz /providers/vllm, aby poznać szczegóły.

SGLang

SGLang jest dostarczany jako dołączony Plugin dostawcy dla szybkich, samodzielnie hostowanych serwerów zgodnych z OpenAI:

• Dostawca: sglang
• Uwierzytelnianie: opcjonalne (zależy od serwera)
• Domyślny bazowy URL: http://127.0.0.1:30000/v1

Aby włączyć lokalne automatyczne wykrywanie (dowolna wartość działa, jeśli serwer nie wymusza uwierzytelniania):

export SGLANG_API_KEY="sglang-local"

Następnie ustaw model (zastąp jednym z identyfikatorów zwracanych przez /v1/models):

{  agents: {    defaults: { model: { primary: "sglang/your-model-id" } },  },}

Zobacz /providers/sglang, aby poznać szczegóły.

Lokalne proxy (LM Studio, vLLM, LiteLLM itd.)

Przykład (zgodny z 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,          },        ],      },    },  },}

Przykłady CLI

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

Zobacz także: Konfiguracja, aby uzyskać pełne przykłady konfiguracji.

Powiązane

• Dokumentacja konfiguracji - klucze konfiguracji modeli
• Przełączanie awaryjne modeli - łańcuchy fallback i zachowanie ponawiania
• Modele - konfiguracja modeli i aliasy
• Dostawcy - przewodniki konfiguracji dla poszczególnych dostawców