Modelproviders

Referentie voor LLM-/modelproviders (niet voor chatkanalen zoals WhatsApp/Telegram). Zie Modellen voor regels voor modelselectie.

Snelle regels

Providers configureren in de Control UI

Open Settings → Model Providers in de Control UI om provider-API-sleutels die zijn opgeslagen in models.providers.<id>.apiKey toe te voegen, te vervangen of te verwijderen. De pagina geeft aan of elke API-sleutel afkomstig is uit de OpenClaw-configuratie of uit een omgevingsvariabele, zonder de referentie te tonen. Sleutels uit de omgeving blijven beheerd door de procesomgeving van de Gateway.

Gebruik Test connection om een live providercontrole uit te voeren en de latentie of een gecategoriseerde authenticatie-, snelheidslimiet-, facturerings-, time-out- of responsfout te bekijken. Een controle voert een echt providerrequest uit en kan een klein aantal tokens verbruiken. Je kunt OAuth- en tokenprofielen ook afmelden via de providerkaart.

De kaart Default models beheert het primaire model, de geordende terugvalmodellen en het hulpmiddelmodel uit de geconfigureerde modelcatalogus. Kies de modellen en sla ze vervolgens samen op in de bestaande instellingen agents.defaults.model en agents.defaults.utilityModel. Voor het hulpmiddelmodel laat Automatic de instelling oningesteld en slaat Disabled een lege tekenreeks op om routering naar hulpmiddelen uit te schakelen.

Providergedrag dat eigendom is van plugins

De meeste providerspecifieke logica bevindt zich in providerplugins (registerProvider(...)), terwijl OpenClaw de generieke inferentielus beheert. Plugins zijn verantwoordelijk voor onboarding, modelcatalogi, toewijzing van authenticatieomgevingsvariabelen, normalisatie van transport/configuratie, opschoning van toolschema's, classificatie voor omschakeling bij fouten, vernieuwing van OAuth, gebruiksrapportage, denk-/redeneerprofielen en meer.

De volledige lijst met provider-SDK-hooks en voorbeelden van gebundelde plugins staat in Providerplugins. Een provider die een volledig aangepaste requestexecutor nodig heeft, is een afzonderlijk, dieper uitbreidingsoppervlak.

Rotatie van API-sleutels

Officiële providerplugins

Officiële providerplugins publiceren hun eigen modelcatalogusrijen. Deze providers vereisen geen models.providers-modelvermeldingen; schakel de providerplugin in, stel de authenticatie in en kies een model. Gebruik models.providers alleen voor expliciete aangepaste providers of specifieke requestinstellingen zoals time-outs.

OpenAI

• Provider: openai
• Authenticatie: OPENAI_API_KEY
• Optionele rotatie: OPENAI_API_KEYS, OPENAI_API_KEY_1, OPENAI_API_KEY_2, plus OPENCLAW_LIVE_OPENAI_KEY (enkele override)
• Standaard voor nieuwe configuraties: openai/gpt-5.6; op de directe API wordt de kale id omgezet naar Sol.
• Voorbeeldmodellen: openai/gpt-5.6, openai/gpt-5.6-terra, openai/gpt-5.6-luna, openai/gpt-5.5
• Controleer de beschikbaarheid voor account/model met openclaw models list --provider openai als een specifieke installatie of API-sleutel zich anders gedraagt.
• CLI: openclaw onboard --auth-choice openai-api-key
• Het standaardtransport is auto; OpenClaw geeft de transportkeuze door aan de gedeelde modelruntime.
• Overschrijf dit per model via agents.defaults.models["openai/<model>"].params.transport ("sse", "websocket" of "auto")
• Prioriteitsverwerking van OpenAI kan worden ingeschakeld via agents.defaults.models["openai/<model>"].params.serviceTier
• /fast en params.fastMode wijzen directe openai/* Responses-requests toe aan service_tier=priority op api.openai.com
• Gebruik params.serviceTier wanneer je een expliciet niveau wilt in plaats van de gedeelde schakelaar /fast
• Verborgen OpenClaw-toeschrijvingsheaders (originator, version, User-Agent) zijn alleen van toepassing op systeemeigen OpenAI-verkeer naar api.openai.com, niet op generieke OpenAI-compatibele proxy's
• Systeemeigen OpenAI-routes behouden ook Responses-store, hints voor de promptcache en vormgeving van payloads voor OpenAI-redeneercompatibiliteit; proxyroutes doen dat niet
• openai/gpt-5.3-codex-spark is alleen beschikbaar via ChatGPT/Codex OAuth; routes met een directe OpenAI-API-sleutel en Azure-API-sleutel weigeren dit

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

Als de API-organisatie GPT-5.6 niet beschikbaar stelt, stel je openai/gpt-5.5 expliciet in. Normale onboarding en herauthenticatie behouden een bestaand expliciet primair model; models auth login --set-default en models set zijn de bewuste vervangingspaden.

Anthropic

• Provider: anthropic
• Authenticatie: ANTHROPIC_API_KEY
• Optionele rotatie: ANTHROPIC_API_KEYS, ANTHROPIC_API_KEY_1, ANTHROPIC_API_KEY_2, plus OPENCLAW_LIVE_ANTHROPIC_KEY (enkele override)
• Voorbeeldmodel: anthropic/claude-opus-5
• CLI: openclaw onboard --auth-choice apiKey
• Directe openbare Anthropic-requests ondersteunen de gedeelde schakelaar /fast en params.fastMode, waaronder verkeer dat met een API-sleutel of OAuth-authenticatie naar api.anthropic.com wordt verzonden; OpenClaw wijst dit toe aan Anthropic service_tier (auto versus standard_only)
• De voorkeursconfiguratie voor Claude CLI houdt de modelreferentie canoniek en selecteert de CLI- backend afzonderlijk: anthropic/claude-opus-5 met modelgebonden agentRuntime.id: "claude-cli". Verouderde claude-cli/claude-opus-4-7-referenties blijven werken voor compatibiliteit.

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

OpenAI ChatGPT/Codex OAuth

• Provider: openai
• Authenticatie: OAuth (ChatGPT)
• Referentie voor verse systeemeigen Codex-app-serverharness: openai/gpt-5.6-sol
• Documentatie voor systeemeigen Codex-app-serverharness: Codex-harness
• Verouderde modelreferenties: codex/gpt-*, openai-codex/gpt-*
• Plugin-grens: openai/* laadt de OpenAI-plugin; expliciet runtimebeleid of de effectieve route van de provider bepaalt of de systeemeigen Codex-app-serverplugin wordt geselecteerd.
• CLI: openclaw onboard --auth-choice openai of openclaw models auth login --provider openai
• Het ingebedde ChatGPT Responses-transport van OpenClaw gebruikt standaard auto (eerst WebSocket, met SSE als fallback).
• agents.defaults.models["openai/<model>"].params.transport, params.serviceTier en params.fastMode zijn ingestelde instellingen voor ingebedde aanvragen. Daarmee blijft de impliciete runtimeselectie bij OpenClaw; systeemeigen Codex beheert het app-servertransport en serviceniveau.
• Verborgen OpenClaw-attributieheaders (originator, version, User-Agent) worden alleen toegevoegd aan systeemeigen Codex-verkeer naar chatgpt.com/backend-api, niet aan algemene OpenAI-compatibele proxy's
• De gedeelde schakeloptie /fast blijft beschikbaar als runtimebesturing; deze staat los van ingestelde modelparameters.
• De systeemeigen Codex-catalogus kan afhankelijk van de accounttoegang exacte referenties voor openai/gpt-5.6-sol, openai/gpt-5.6-terra en openai/gpt-5.6-luna beschikbaar stellen. De kale alias gpt-5.6 van de directe API wordt niet aan de clientzijde toegepast.
• openai/gpt-5.5 gebruikt de systeemeigen Codex-catalogus contextWindow = 400000 en de standaardruntime contextTokens = 272000; overschrijf de runtimelimiet met models.providers.openai.models[].contextTokens
• Meld je aan met openai-authenticatie en gebruik openai/gpt-5.6-sol voor een nieuwe, door een abonnement ondersteunde configuratie. Selecteer openai/gpt-5.5 expliciet als GPT-5.6 niet beschikbaar is in die Codex-werkruimte.
• Gebruik provider/model agentRuntime.id: "openclaw" om een verder geschikte route op de ingebouwde runtime te houden. Als de runtime niet is ingesteld of auto is, kan Codex alleen impliciet worden geselecteerd voor een exacte officiële HTTPS-route die compatibel is met Responses/ChatGPT en geen ingestelde aanvraagoverschrijving heeft.
• Verouderde Codex GPT-referenties zijn verouderde status, geen actieve providerroute. Gebruik canonieke openai/*-referenties voor nieuwe agentconfiguratie en voer openclaw doctor --fix uit om codex/*- en openai-codex/*-referenties te migreren, waarbij hun systeemeigen Codex-semantiek behouden blijft met modelgebonden agentRuntime.id: "codex". Bestaande expliciete canonieke openai/gpt-5.5-selecties worden niet bijgewerkt.

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

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

Andere gehoste opties in abonnementsstijl

OpenCode

• Authenticatie: OPENCODE_API_KEY (of OPENCODE_ZEN_API_KEY)
• Zen-runtimeprovider: opencode
• Go-runtimeprovider: opencode-go
• Voorbeeldmodellen: opencode/claude-opus-4-6, opencode-go/kimi-k2.6
• CLI: openclaw onboard --auth-choice opencode-zen of openclaw onboard --auth-choice opencode-go

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

Google Gemini (API-sleutel)

• Provider: google
• Authenticatie: GEMINI_API_KEY
• Optionele rotatie: GEMINI_API_KEYS, GEMINI_API_KEY_1, GEMINI_API_KEY_2, GOOGLE_API_KEY als fallback en OPENCLAW_LIVE_GEMINI_KEY (één overschrijving)
• Voorbeeldmodellen: google/gemini-3.1-pro-preview, google/gemini-3.5-flash
• Compatibiliteit: verouderde OpenClaw-configuratie met google/gemini-3.1-flash-preview wordt genormaliseerd naar google/gemini-3-flash-preview
• Alias: google/gemini-3.1-pro wordt geaccepteerd en genormaliseerd naar de actieve Gemini API-id van Google, google/gemini-3.1-pro-preview
• CLI: openclaw onboard --auth-choice gemini-api-key
• Redeneren: /think adaptive gebruikt dynamisch redeneren van Google. Gemini 3/3.1 laten een vaste thinkingLevel weg; Gemini 2.5 verzendt thinkingBudget: -1.
• Directe Gemini-runs accepteren ook agents.defaults.models["google/<model>"].params.cachedContent (of het verouderde cached_content) om een providerspecifieke cachedContents/...-handle door te sturen; Gemini-cachetreffers worden weergegeven als OpenClaw cacheRead

Google Vertex en Gemini CLI

• Providers: google-vertex, google-gemini-cli
• Authenticatie: Vertex gebruikt gcloud ADC; Gemini CLI gebruikt de eigen OAuth-flow

Gemini CLI OAuth wordt geleverd als onderdeel van de gebundelde google-plugin.

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 gebruikt standaard stream-json. OpenClaw leest streamberichten van de assistent en normaliseert stats.cached naar cacheRead; verouderde --output-format json-overschrijvingen lezen antwoordtekst nog steeds uit response.

Z.AI (GLM)

• Provider: zai
• Authenticatie: ZAI_API_KEY
• Voorbeeldmodel: zai/glm-5.2
• CLI: openclaw onboard --auth-choice zai-api-key
  • Modelreferenties gebruiken de canonieke provider-id zai/*.
  • zai-api-key detecteert automatisch het bijbehorende Z.AI-eindpunt; zai-coding-global, zai-coding-cn, zai-global en zai-cn dwingen een specifiek oppervlak af

Vercel AI Gateway

• Provider: vercel-ai-gateway
• Authenticatie: AI_GATEWAY_API_KEY
• Voorbeeldmodellen: vercel-ai-gateway/anthropic/claude-opus-4.6, vercel-ai-gateway/moonshotai/kimi-k2.6
• CLI: openclaw onboard --auth-choice ai-gateway-api-key

Andere gebundelde providerplugins

Bijzonderheden die je moet kennen

Providers via models.providers (aangepaste/basis-URL)

Gebruik models.providers (of models.json) om aangepaste providers of OpenAI-/Anthropic-compatibele proxy's toe te voegen.

Veel van de onderstaande gebundelde providerplugins publiceren al een standaardcatalogus. Gebruik expliciete models.providers.<id>-vermeldingen alleen als je de standaardbasis-URL, headers of modellenlijst wilt overschrijven.

Gebundelde en in de catalogus bekende routes ontlenen hun compat-mogelijkheden aan de verantwoordelijke providerplugin. Een configuratieblok compat is bedoeld voor een aangepaste provider of een aangepast model, of voor een andere api-/baseUrl-route waarvan je het endpointcontract hebt geverifieerd; zie de handleiding voor mogelijkheden van aangepaste providers. Doctor verwijdert verouderde waarden die slechts de catalogus herhalen en laat afwijkende waarden zichtbaar voor beoordeling door de beheerder.

Controles van modelmogelijkheden door de Gateway lezen ook expliciete models.providers.<id>.models[]-metadata. Als een aangepast model of proxymodel afbeeldingen accepteert, stel je input: ["text", "image"] in voor dat model, zodat WebChat en bijlagenpaden die vanuit een Node afkomstig zijn afbeeldingen doorgeven als native modelinvoer in plaats van alleen-tekstmediaverwijzingen.

agents.defaults.models["provider/model"] beheert aliassen en metadata per model voor agents. Het beperkt geen overschrijvingen en registreert op zichzelf ook geen nieuw runtimemodel. Voeg voor modellen van aangepaste providers ook models.providers.<provider>.models[] toe met ten minste de overeenkomende id; gebruik agents.defaults.modelPolicy.allow afzonderlijk wanneer je een beperking voor overschrijvingen wilt.

Moonshot AI (Kimi)

Installeer @openclaw/moonshot-provider vóór de onboarding. Voeg alleen een expliciete models.providers.moonshot-vermelding toe als je de basis-URL of modelmetadata moet overschrijven:

• Provider: moonshot
• Authenticatie: MOONSHOT_API_KEY
• Voorbeeldmodel: moonshot/kimi-k3
• CLI: openclaw onboard --auth-choice moonshot-api-key of openclaw onboard --auth-choice moonshot-api-key-cn

Kimi-model-id's:

• moonshot/kimi-k2.6
• moonshot/kimi-k3
• moonshot/kimi-k2.7-code
• moonshot/kimi-k2.7-code-highspeed
• moonshot/kimi-k2.5

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

Zie Moonshot AI (Kimi + Kimi Coding) voor de volledige installatiehandleiding.

Kimi Coding

Kimi Coding gebruikt het Anthropic-compatibele endpoint van Moonshot AI:

• Provider: kimi
• Authenticatie: KIMI_API_KEY
• Kimi K3: kimi/k3 (256K) of kimi/k3[1m] (1M-abonnement)
• Kimi Code: kimi/kimi-for-coding
• Kimi Code HighSpeed: kimi/kimi-for-coding-highspeed

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

Verouderde kimi/kimi-code en kimi/k2p5 blijven geaccepteerd als compatibiliteitsmodel-id's en worden genormaliseerd naar het stabiele API-model-id van Kimi.

Volcano Engine (Doubao)

Volcano Engine (火山引擎) biedt in China toegang tot Doubao en andere modellen.

• Provider: volcengine (programmeren: volcengine-plan)
• Authenticatie: VOLCANO_ENGINE_API_KEY
• Voorbeeldmodel: volcengine-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice volcengine-api-key

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

Onboarding gebruikt standaard het programmeeroppervlak, maar de algemene volcengine/*-catalogus wordt tegelijkertijd geregistreerd.

In de modelkeuzelijsten voor onboarding/configuratie geeft de Volcengine-authenticatiekeuze de voorkeur aan zowel volcengine/*- als volcengine-plan/*-rijen. Als die modellen nog niet zijn geladen, valt OpenClaw terug op de ongefilterde catalogus in plaats van een lege, tot de provider beperkte keuzelijst weer te geven.

BytePlus (internationaal)

BytePlus ARK biedt internationale gebruikers toegang tot dezelfde modellen als Volcano Engine.

• Provider: byteplus (coderen: byteplus-plan)
• Authenticatie: BYTEPLUS_API_KEY
• Voorbeeldmodel: byteplus-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice byteplus-api-key

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

De onboarding gebruikt standaard het codeeroppervlak, maar de algemene byteplus/*-catalogus wordt tegelijkertijd geregistreerd.

In modelkiezers voor onboarding/configuratie geeft de BytePlus-authenticatiekeuze de voorkeur aan zowel de rijen byteplus/* als byteplus-plan/*. Als die modellen nog niet zijn geladen, valt OpenClaw terug op de ongefilterde catalogus in plaats van een lege, tot de provider beperkte kiezer te tonen.

Synthetic

Synthetic biedt Anthropic-compatibele modellen via de provider synthetic:

• Provider: synthetic
• Authenticatie: SYNTHETIC_API_KEY
• Voorbeeldmodel: synthetic/hf:MiniMaxAI/MiniMax-M3
• CLI: openclaw onboard --auth-choice synthetic-api-key

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

MiniMax

MiniMax wordt via models.providers geconfigureerd omdat het aangepaste eindpunten gebruikt:

• MiniMax OAuth (wereldwijd): --auth-choice minimax-global-oauth
• MiniMax OAuth (CN): --auth-choice minimax-cn-oauth
• MiniMax-API-sleutel (wereldwijd): --auth-choice minimax-global-api
• MiniMax-API-sleutel (CN): --auth-choice minimax-cn-api
• Authenticatie: MINIMAX_API_KEY voor minimax; MINIMAX_OAUTH_TOKEN of MINIMAX_API_KEY voor minimax-portal

Zie /providers/minimax voor installatiedetails, modelopties en configuratiefragmenten.

Door de Plugin beheerde verdeling van mogelijkheden:

• Standaardinstellingen voor tekst/chat blijven op minimax/MiniMax-M3
• Afbeeldingen genereren gebruikt minimax/image-01 of minimax-portal/image-01
• Afbeeldingsbegrip gebruikt de door de Plugin beheerde MiniMax-VL-01 op beide MiniMax-authenticatiepaden
• Zoeken op internet blijft op provider-id minimax

LM Studio

LM Studio wordt geleverd als een gebundelde provider-Plugin die de systeemeigen API gebruikt:

• Provider: lmstudio
• Authenticatie: LM_API_TOKEN
• Standaardbasis-URL voor inferentie: http://localhost:1234/v1

Stel vervolgens een model in (vervang dit door een van de ID's die http://localhost:1234/api/v1/models retourneert):

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

OpenClaw gebruikt de systeemeigen /api/v1/models en /api/v1/models/load van LM Studio voor detectie en automatisch laden, met standaard /v1/chat/completions voor inferentie. Als je wilt dat JIT-laden, TTL en automatisch verwijderen van LM Studio de modellevenscyclus beheren, stel je models.providers.lmstudio.params.preload: false in. Zie /providers/lmstudio voor installatie en probleemoplossing.

Ollama

Ollama wordt geleverd als een gebundelde provider-Plugin en gebruikt de systeemeigen API van Ollama:

• Provider: ollama
• Authenticatie: Niet vereist (lokale server)
• Voorbeeldmodel: ollama/llama3.3
• Installatie: https://ollama.com/download

# Installeer Ollama en haal vervolgens een model op:ollama pull llama3.3

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

Ollama wordt lokaal gedetecteerd op http://127.0.0.1:11434 wanneer je dit inschakelt met OLLAMA_API_KEY, en de gebundelde provider-Plugin voegt Ollama rechtstreeks toe aan openclaw onboard en de modelkiezer. Zie /providers/ollama voor onboarding, cloud-/lokale modus en aangepaste configuratie.

vLLM

vLLM wordt geleverd als een gebundelde provider-Plugin voor lokale/zelfgehoste OpenAI-compatibele servers:

• Provider: vllm
• Authenticatie: Optioneel (afhankelijk van je server)
• Standaardbasis-URL: http://127.0.0.1:8000/v1

Om lokale automatische detectie in te schakelen (elke waarde werkt als je server geen authenticatie afdwingt):

export VLLM_API_KEY="vllm-local"

Stel vervolgens een model in (vervang dit door een van de ID's die /v1/models retourneert):

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

Zie /providers/vllm voor details.

SGLang

SGLang wordt geleverd als een gebundelde provider-Plugin voor snelle, zelfgehoste OpenAI-compatibele servers:

• Provider: sglang
• Authenticatie: Optioneel (afhankelijk van je server)
• Standaardbasis-URL: http://127.0.0.1:30000/v1

Om lokale automatische detectie in te schakelen (elke waarde werkt als je server geen authenticatie afdwingt):

export SGLANG_API_KEY="sglang-local"

Stel vervolgens een model in (vervang dit door een van de ID's die /v1/models retourneert):

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

Zie /providers/sglang voor details.

Lokale proxy's (LM Studio, vLLM, LiteLLM enz.)

Voorbeeld (OpenAI-compatibel):

{  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-voorbeelden

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

Zie ook: Configuratie voor volledige configuratievoorbeelden.

Gerelateerd

• Configuratiereferentie - modelconfiguratiesleutels
• Model-failover - fallbackketens en gedrag bij nieuwe pogingen
• Modellen - modelconfiguratie en aliassen
• Providers - installatiehandleidingen per provider