Modelproviders - OpenClaw

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

Snelle regels

Modelrefs en CLI-helpers

Modelrefs gebruiken provider/model (voorbeeld: opencode/claude-opus-4-6).
agents.defaults.models werkt als een allowlist wanneer dit is ingesteld.
CLI-helpers: openclaw onboard, openclaw models list, openclaw models set <provider/model>.
models.providers.*.contextWindow / contextTokens / maxTokens stellen standaardwaarden op providerniveau in; models.providers.*.models[].contextWindow / contextTokens / maxTokens overschrijven ze per model.
Fallbackregels, cooldown-probes en persistentie van sessie-overschrijvingen: Model-failover.

Provider-auth toevoegen verandert je primaire model niet

openclaw configure behoudt een bestaande agents.defaults.model.primary wanneer je een provider toevoegt of opnieuw autoriseert. openclaw models auth login doet hetzelfde, tenzij je --set-default doorgeeft. Provider-Plugins kunnen nog steeds een aanbevolen standaardmodel teruggeven in hun auth-configuratiepatch, maar OpenClaw behandelt dat als make this model available wanneer er al een primair model bestaat, niet als replace the current primary model.Gebruik openclaw models set <provider/model> of openclaw models auth login --provider <id> --set-default om het standaardmodel bewust te wisselen.

OpenAI provider/runtime-scheiding

OpenAI-familieroutes zijn prefixspecifiek:

openai/<model> gebruikt standaard de native Codex app-server-harness voor agentbeurten. Dit is de gebruikelijke ChatGPT/Codex-abonnementsconfiguratie.
legacy Codex-modelrefs zijn legacy-configuratie die doctor herschrijft naar openai/<model>.
openai/<model> plus provider/model agentRuntime.id: "openclaw" gebruikt de ingebouwde runtime van OpenClaw voor expliciete API-sleutel- of compatibiliteitsroutes.

Zie OpenAI en Codex-harness. Als de provider/runtime-scheiding verwarrend is, lees dan eerst Agent-runtimes.Automatisch inschakelen van Plugins volgt dezelfde grens: openai/*-agentrefs schakelen de Codex-Plugin in voor de standaardroute, en expliciete provider/model agentRuntime.id: "codex"- of legacy codex/<model>-refs vereisen deze ook.GPT-5.5 is standaard beschikbaar via de native Codex app-server-harness op openai/gpt-5.5, en via de OpenClaw-runtime wanneer provider/model-runtimebeleid expliciet openclaw selecteert.

CLI-runtimes

CLI-runtimes gebruiken dezelfde scheiding: kies canonieke modelrefs zoals anthropic/claude-* of google/gemini-*, en stel daarna provider/model-runtimebeleid in op claude-cli of google-gemini-cli wanneer je een lokale CLI-backend wilt.Legacy claude-cli/*- en google-gemini-cli/*-refs migreren terug naar canonieke providerrefs met de runtime apart vastgelegd. Legacy codex-cli/*-refs migreren naar openai/* en gebruiken de Codex app-server-route; OpenClaw houdt geen gebundelde Codex CLI-backend meer bij.

Providergedrag in eigendom van Plugins

De meeste providerspecifieke logica zit in provider-Plugins (registerProvider(...)), terwijl OpenClaw de generieke inferentielus behoudt. Plugins zijn eigenaar van onboarding, modelcatalogi, auth-env-var-mapping, transport-/configuratienormalisatie, opschoning van tool-schema’s, failoverclassificatie, OAuth-verversing, gebruiksrapportage, denk-/redeneerprofielen en meer. De volledige lijst met provider-SDK-hooks en voorbeelden van gebundelde Plugins staat in Provider-Plugins. Een provider die een volledig aangepaste request-executor nodig heeft, is een apart, dieper uitbreidingsoppervlak.

Runnergedrag in eigendom van providers leeft op expliciete providerhooks, zoals replaybeleid, tool-schema-normalisatie, stream-wrapping en transport-/requesthelpers. De legacy statische tas ProviderPlugin.capabilities is alleen voor compatibiliteit en wordt niet meer gelezen door gedeelde runnerlogica.

API-sleutelrotatie

Sleutelbronnen en prioriteit

Configureer meerdere sleutels via:

OPENCLAW_LIVE_<PROVIDER>_KEY (enkele live-overschrijving, hoogste prioriteit)
<PROVIDER>_API_KEYS (lijst met komma’s of puntkomma’s)
<PROVIDER>_API_KEY (primaire sleutel)
<PROVIDER>_API_KEY_* (genummerde lijst, bijvoorbeeld <PROVIDER>_API_KEY_1)

Voor Google-providers wordt GOOGLE_API_KEY ook meegenomen als fallback. De sleutelselectievolgorde behoudt prioriteit en dedupliceert waarden.

Wanneer rotatie start

Requests worden alleen opnieuw geprobeerd met de volgende sleutel bij rate-limit-responses (bijvoorbeeld 429, rate_limit, quota, resource exhausted, Too many concurrent requests, ThrottlingException, concurrency limit reached, workers_ai ... quota limit exceeded of periodieke berichten over gebruikslimieten).
Fouten die geen rate-limit zijn, falen direct; er wordt geen sleutelrotatie geprobeerd.
Wanneer alle kandidaatsleutels falen, wordt de uiteindelijke fout teruggegeven vanuit de laatste poging.

Officiële provider-Plugins

Officiële provider-Plugins publiceren hun eigen modelcatalogusrijen. Deze providers vereisen geen modelvermeldingen in models.providers; schakel de provider-Plugin in, stel auth in en kies een model. Gebruik models.providers alleen voor expliciete aangepaste providers of smalle requestinstellingen zoals time-outs.

OpenAI

Provider: openai
Auth: OPENAI_API_KEY
Optionele rotatie: OPENAI_API_KEYS, OPENAI_API_KEY_1, OPENAI_API_KEY_2, plus OPENCLAW_LIVE_OPENAI_KEY (enkele overschrijving)
Voorbeeldmodellen: openai/gpt-5.5, openai/gpt-5.4-mini
Verifieer account-/modelbeschikbaarheid met openclaw models list --provider openai als een specifieke installatie of API-sleutel zich anders gedraagt.
CLI: openclaw onboard --auth-choice openai-api-key
Standaardtransport is auto; OpenClaw geeft de transportkeuze door aan de gedeelde modelruntime.
Overschrijf per model via agents.defaults.models["openai/<model>"].params.transport ("sse", "websocket" of "auto")
OpenAI-prioriteitsverwerking kan worden ingeschakeld via agents.defaults.models["openai/<model>"].params.serviceTier
/fast en params.fastMode mappen directe openai/* Responses-requests naar service_tier=priority op api.openai.com
Gebruik params.serviceTier wanneer je een expliciete laag wilt in plaats van de gedeelde /fast-schakelaar
Verborgen OpenClaw-attributieheaders (originator, version, User-Agent) gelden alleen voor native OpenAI-verkeer naar api.openai.com, niet voor generieke OpenAI-compatibele proxy’s
Native OpenAI-routes behouden ook Responses store, prompt-cachehints en OpenAI reasoning-compat-payloadvorming; proxyroutes doen dat niet
openai/gpt-5.3-codex-spark is beschikbaar via ChatGPT/Codex OAuth-abonnementsauth wanneer je ingelogde account dit beschikbaar stelt; OpenClaw onderdrukt nog steeds directe OpenAI API-sleutel- en Azure API-sleutelroutes voor dit model omdat die transports het weigeren

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

Anthropic

Provider: anthropic
Auth: ANTHROPIC_API_KEY
Optionele rotatie: ANTHROPIC_API_KEYS, ANTHROPIC_API_KEY_1, ANTHROPIC_API_KEY_2, plus OPENCLAW_LIVE_ANTHROPIC_KEY (enkele overschrijving)
Voorbeeldmodel: anthropic/claude-opus-4-6
CLI: openclaw onboard --auth-choice apiKey
Directe publieke Anthropic-requests ondersteunen de gedeelde /fast-schakelaar en params.fastMode, inclusief API-sleutel- en OAuth-geauthenticeerd verkeer dat naar api.anthropic.com wordt gestuurd; OpenClaw mapt dat naar Anthropic service_tier (auto versus standard_only)
Aanbevolen Claude CLI-configuratie houdt de modelref canoniek en selecteert de CLI backend apart: anthropic/claude-opus-4-8 met modelgescopeerde agentRuntime.id: "claude-cli". Legacy claude-cli/claude-opus-4-7-refs blijven werken voor compatibiliteit.

Anthropic-medewerkers hebben ons verteld dat OpenClaw-achtig Claude CLI-gebruik weer is toegestaan, dus OpenClaw behandelt hergebruik van Claude CLI en gebruik van claude -p als goedgekeurd voor deze integratie, tenzij Anthropic een nieuw beleid publiceert. Anthropic setup-token blijft beschikbaar als een ondersteund OpenClaw-tokenpad, maar OpenClaw geeft nu de voorkeur aan hergebruik van Claude CLI en claude -p wanneer beschikbaar.

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

OpenAI ChatGPT/Codex OAuth

Provider: openai
Auth: OAuth (ChatGPT)
Legacy OpenAI Codex-modelref: openai/gpt-5.5
Native Codex app-server-harnessref: openai/gpt-5.5
Native Codex app-server-harnessdocs: Codex-harness
Legacy modelrefs: codex/gpt-*
Plugin-grens: openai/* laadt de OpenAI-Plugin; de native Codex app-server-Plugin wordt geselecteerd door de Codex-harnessruntime.
CLI: openclaw onboard --auth-choice openai of openclaw models auth login --provider openai
Standaardtransport is auto (WebSocket eerst, SSE als fallback)
Overschrijf per OpenAI Codex-model via agents.defaults.models["openai/<model>"].params.transport ("sse", "websocket" of "auto")
params.serviceTier wordt ook doorgestuurd bij native Codex Responses-requests (chatgpt.com/backend-api)
Verborgen OpenClaw-attributieheaders (originator, version, User-Agent) worden alleen toegevoegd aan native Codex-verkeer naar chatgpt.com/backend-api, niet aan generieke OpenAI-compatibele proxy’s
Deelt dezelfde /fast-schakelaar en params.fastMode-configuratie als directe openai/*; OpenClaw mapt dat naar service_tier=priority
openai/gpt-5.5 gebruikt de native contextWindow = 400000 van de Codex-catalogus en standaardruntime contextTokens = 272000; overschrijf de runtimelimiet met models.providers.openai.models[].contextTokens
Beleidsnotitie: OpenAI Codex OAuth wordt expliciet ondersteund voor externe tools/workflows zoals OpenClaw.
Voor de gebruikelijke route met abonnement plus native Codex-runtime log je in met openai-auth en configureer je openai/gpt-5.5; OpenAI-agentbeurten selecteren standaard Codex.
Gebruik provider/model agentRuntime.id: "openclaw" alleen wanneer je de ingebouwde OpenClaw-route wilt; houd anders openai/gpt-5.5 op de standaard Codex-harness.
legacy Codex GPT-refs zijn legacy-state, geen live providerroute. Gebruik openai/gpt-5.5 op de native Codex-runtime voor nieuwe agentconfiguratie, en voer openclaw doctor --fix uit om oude legacy Codex-modelrefs te migreren naar canonieke openai/*-refs.

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

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

Andere gehoste opties in abonnementsstijl

Z.AI (GLM)

Z.AI Coding Plan of algemene API-eindpunten.

MiniMax

MiniMax Coding Plan OAuth of toegang met API-sleutel.

Qwen Cloud

Qwen Cloud-provideroppervlak plus Alibaba DashScope- en Coding Plan-eindpuntmapping.

OpenCode

Auth: 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-fallback en OPENCLAW_LIVE_GEMINI_KEY (enkele override)
Voorbeeldmodellen: google/gemini-3.1-pro-preview, google/gemini-3-flash-preview
Compatibiliteit: verouderde OpenClaw-configuratie die google/gemini-3.1-flash-preview gebruikt, wordt genormaliseerd naar google/gemini-3-flash-preview
Alias: google/gemini-3.1-pro wordt geaccepteerd en genormaliseerd naar Google’s live Gemini API-id, google/gemini-3.1-pro-preview
CLI: openclaw onboard --auth-choice gemini-api-key
Denken: /think adaptive gebruikt Google dynamic thinking. 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 verouderd cached_content) om een provider-native cachedContents/...-handle door te sturen; Gemini-cachehits verschijnen als OpenClaw cacheRead

Google Vertex en Gemini CLI

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

Gemini CLI OAuth in OpenClaw is een onofficiële integratie. Sommige gebruikers hebben Google-accountbeperkingen gemeld na gebruik van clients van derden. Bekijk de voorwaarden van Google en gebruik een niet-kritiek account als je ervoor kiest door te gaan.

Gemini CLI OAuth wordt meegeleverd als onderdeel van de gebundelde google-Plugin.

Install Gemini CLI

brew
npm

brew install gemini-cli

npm install -g @google/gemini-cli

Enable plugin

openclaw plugins enable google

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

Standaardmodel: google-gemini-cli/gemini-3-flash-preview. Je plakt geen client-id of secret in openclaw.json. De CLI-loginflow slaat tokens op in authenticatieprofielen op de gateway-host.

Set project (if needed)

Als requests na het inloggen mislukken, stel dan GOOGLE_CLOUD_PROJECT of GOOGLE_CLOUD_PROJECT_ID in op de gateway-host.

Gemini CLI gebruikt standaard stream-json. OpenClaw leest assistant-streamberichten en normaliseert stats.cached naar cacheRead; verouderde --output-format json-overrides lezen nog steeds antwoordtekst uit response.

Z.AI (GLM)

Provider: zai
Authenticatie: ZAI_API_KEY
Voorbeeldmodel: zai/glm-5.2
CLI: openclaw onboard --auth-choice zai-api-key
- Modelrefs gebruiken de canonieke zai/*-provider-ID.
- zai-api-key detecteert automatisch het bijpassende Z.AI-eindpunt; zai-coding-global, zai-coding-cn, zai-global en zai-cn forceren een specifiek oppervlak

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 provider-Plugins

Provider	ID	Authenticatie-env	Voorbeeldmodel
BytePlus	`byteplus` / `byteplus-plan`	`BYTEPLUS_API_KEY`	`byteplus-plan/ark-code-latest`
ClawRouter	`clawrouter`	`CLAWROUTER_API_KEY`	`clawrouter/anthropic/claude-sonnet-4-6`
Cohere	`cohere`	`COHERE_API_KEY`	`cohere/command-a-03-2025`
GitHub Copilot	`github-copilot`	`COPILOT_GITHUB_TOKEN` / `GH_TOKEN` / `GITHUB_TOKEN`	-
Hugging Face Inference	`huggingface`	`HUGGINGFACE_HUB_TOKEN` of `HF_TOKEN`	`huggingface/deepseek-ai/DeepSeek-R1`
MiniMax	`minimax` / `minimax-portal`	`MINIMAX_API_KEY` / `MINIMAX_OAUTH_TOKEN`	`minimax/MiniMax-M3`
Mistral	`mistral`	`MISTRAL_API_KEY`	`mistral/mistral-large-latest`
Moonshot	`moonshot`	`MOONSHOT_API_KEY`	`moonshot/kimi-k2.6`
NVIDIA	`nvidia`	`NVIDIA_API_KEY`	`nvidia/nvidia/nemotron-3-ultra-550b-a55b`
NovitaAI	`novita`	`NOVITA_API_KEY`	`novita/deepseek/deepseek-v3-0324`
Ollama Cloud	`ollama-cloud`	`OLLAMA_API_KEY`	`ollama-cloud/kimi-k2.6`
OpenRouter	`openrouter`	OpenRouter OAuth of `OPENROUTER_API_KEY`	`openrouter/auto`
Qwen OAuth	`qwen-oauth`	`QWEN_API_KEY`	`qwen-oauth/qwen3.5-plus`
Together	`together`	`TOGETHER_API_KEY`	`together/meta-llama/Llama-3.3-70B-Instruct-Turbo`
Venice	`venice`	`VENICE_API_KEY`	-
Vercel AI Gateway	`vercel-ai-gateway`	`AI_GATEWAY_API_KEY`	`vercel-ai-gateway/anthropic/claude-opus-4.6`
Volcano Engine (Doubao)	`volcengine` / `volcengine-plan`	`VOLCANO_ENGINE_API_KEY`	`volcengine-plan/ark-code-latest`
xAI	`xai`	SuperGrok/X Premium OAuth of `XAI_API_KEY`	`xai/grok-4.3`
Xiaomi	`xiaomi` / `xiaomi-token-plan`	`XIAOMI_API_KEY` / `XIAOMI_TOKEN_PLAN_API_KEY`	`xiaomi/mimo-v2-flash` / `xiaomi-token-plan/mimo-v2.5-pro`

Bijzonderheden die nuttig zijn om te weten

OpenRouter

Past zijn app-attributieheaders en Anthropic cache_control-markeringen alleen toe op geverifieerde openrouter.ai-routes. DeepSeek-, Moonshot- en ZAI-refs komen in aanmerking voor cache-TTL voor door OpenRouter beheerde promptcaching, maar ontvangen geen Anthropic-cachemarkeringen. Als proxy-achtige OpenAI-compatibele route slaat deze native-OpenAI-only vormgeving over (serviceTier, Responses store, promptcache-hints, OpenAI reasoning-compat). Gemini-ondersteunde refs behouden alleen proxy-Gemini thought-signature-opschoning.

Kilo Gateway

Gemini-ondersteunde refs volgen hetzelfde proxy-Gemini-opschoningspad; kilocode/kilo/auto en andere refs zonder ondersteuning voor proxy-redeneren slaan proxy-reasoning-injectie over.

MiniMax

API-key-onboarding schrijft expliciete M3- en M2.7-chatmodeldefinities; afbeeldingsbegrip blijft op de Plugin-owned MiniMax-VL-01-mediaprovider.

NVIDIA

Model-ID’s gebruiken een nvidia/<vendor>/<model>-namespace (bijvoorbeeld nvidia/nvidia/nemotron-... naast nvidia/moonshotai/kimi-k2.5); pickers behouden de letterlijke <provider>/<model-id>-samenstelling terwijl de canonieke sleutel die naar de API wordt verzonden enkelvoudig geprefixt blijft.

xAI

Gebruikt het xAI Responses-pad. Het aanbevolen pad is SuperGrok/X Premium OAuth; API-sleutels werken nog steeds via XAI_API_KEY of Plugin-configuratie, en Grok web_search hergebruikt hetzelfde authenticatieprofiel vóór de API-key-fallback. grok-4.3 is het gebundelde standaardchatmodel, en grok-build-0.1 is selecteerbaar voor build-/codegericht werk. /fast of params.fastMode: true herschrijft grok-3, grok-3-mini, grok-4 en grok-4-0709 naar hun *-fast-varianten. tool_stream staat standaard aan; schakel uit via agents.defaults.models["xai/<model>"].params.tool_stream=false.

Providers via `models.providers` (aangepaste/base-URL)

Gebruik models.providers (of models.json) om aangepaste providers of OpenAI/Anthropic-compatibele proxy’s toe te voegen. Veel van de hieronder gebundelde provider-plugins publiceren al een standaardcatalogus. Gebruik expliciete models.providers.<id>-vermeldingen alleen wanneer je de standaardbasis-URL, headers of modellenlijst wilt overschrijven. Gateway-controles voor modelmogelijkheden lezen ook expliciete models.providers.<id>.models[]-metadata. Als een aangepast model of proxymodel afbeeldingen accepteert, stel dan input: ["text", "image"] in op dat model, zodat WebChat en node-origin-bijlagepaden afbeeldingen doorgeven als native modelinvoer in plaats van mediarefs die alleen tekst zijn. agents.defaults.models["provider/model"] regelt alleen modelzichtbaarheid, aliassen en metadata per model voor agents. Het registreert op zichzelf geen nieuw runtimemodel. Voeg voor aangepaste providermodellen ook models.providers.<provider>.models[] toe met ten minste de overeenkomende id.

Moonshot AI (Kimi)

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

Provider: moonshot
Auth: MOONSHOT_API_KEY
Voorbeeldmodel: moonshot/kimi-k2.6
CLI: openclaw onboard --auth-choice moonshot-api-key of openclaw onboard --auth-choice moonshot-api-key-cn

Kimi K2-model-ID’s:

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-coderen

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

Provider: kimi
Auth: KIMI_API_KEY
Voorbeeldmodel: kimi/kimi-for-coding

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

Legacy kimi/kimi-code en kimi/k2p5 blijven geaccepteerd als compatibiliteitsmodel-ID’s en worden genormaliseerd naar Kimi’s stabiele API-model-ID.

Volcano Engine (Doubao)

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

Provider: volcengine (coderen: volcengine-plan)
Auth: 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 codeeroppervlak, maar de algemene volcengine/*-catalogus wordt tegelijk geregistreerd. In modelkiezers voor onboarding/configuratie geeft de Volcengine-authkeuze 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 provider-specifieke kiezer te tonen.

Standaardmodellen
Codeermodellen (volcengine-plan)

volcengine/doubao-seed-1-8-251228 (Doubao Seed 1.8)
volcengine/doubao-seed-code-preview-251028
volcengine/kimi-k2-5-260127 (Kimi K2.5)
volcengine/glm-4-7-251222 (GLM 4.7)
volcengine/deepseek-v3-2-251201 (DeepSeek V3.2 128K)

volcengine-plan/ark-code-latest
volcengine-plan/doubao-seed-code
volcengine-plan/kimi-k2.5
volcengine-plan/kimi-k2-thinking
volcengine-plan/glm-4.7

BytePlus (internationaal)

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

Provider: byteplus (coderen: byteplus-plan)
Auth: 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" } },
  },
}

Onboarding gebruikt standaard het codeeroppervlak, maar de algemene byteplus/*-catalogus wordt tegelijk geregistreerd. In modelkiezers voor onboarding/configuratie geeft de BytePlus-authkeuze de voorkeur aan zowel byteplus/*- als byteplus-plan/*-rijen. Als die modellen nog niet zijn geladen, valt OpenClaw terug op de ongefilterde catalogus in plaats van een lege provider-specifieke kiezer te tonen.

Standaardmodellen
Codeermodellen (byteplus-plan)

byteplus/seed-1-8-251228 (Seed 1.8)
byteplus/kimi-k2-5-260127 (Kimi K2.5)
byteplus/glm-4-7-251222 (GLM 4.7)

byteplus-plan/ark-code-latest
byteplus-plan/doubao-seed-code
byteplus-plan/kimi-k2.5
byteplus-plan/kimi-k2-thinking
byteplus-plan/glm-4.7

Synthetic

Synthetic biedt Anthropic-compatibele modellen achter de provider synthetic:

Provider: synthetic
Auth: SYNTHETIC_API_KEY
Voorbeeldmodel: 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 wordt geconfigureerd via models.providers, omdat het aangepaste endpoints gebruikt:

MiniMax OAuth (Global): --auth-choice minimax-global-oauth
MiniMax OAuth (CN): --auth-choice minimax-cn-oauth
MiniMax API key (Global): --auth-choice minimax-global-api
MiniMax API key (CN): --auth-choice minimax-cn-api
Auth: MINIMAX_API_KEY voor minimax; MINIMAX_OAUTH_TOKEN of MINIMAX_API_KEY voor minimax-portal

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

Op MiniMax’ Anthropic-compatibele streamingpad schakelt OpenClaw denken standaard uit voor de M2.x-familie, tenzij je dit expliciet instelt; MiniMax-M3 (en M3.x) blijft standaard op het weggelaten/adaptieve denkpad van de provider. /fast on herschrijft MiniMax-M2.7 naar MiniMax-M2.7-highspeed.

Door Plugin beheerde capability-splitsing:

Standaarden voor tekst/chat blijven op minimax/MiniMax-M3
Afbeeldingsgeneratie is minimax/image-01 of minimax-portal/image-01
Afbeeldingsbegrip is door de plugin beheerde MiniMax-VL-01 op beide MiniMax-authpaden
Webzoekopdrachten blijven op provider-id minimax

LM Studio

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

Provider: lmstudio
Auth: LM_API_TOKEN
Standaard basis-URL voor inferentie: http://localhost:1234/v1

Stel daarna 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 LM Studio’s native /api/v1/models en /api/v1/models/load voor detectie en automatisch laden, met standaard /v1/chat/completions voor inferentie. Als je wilt dat LM Studio JIT-laden, TTL en automatisch uitwerpen de levenscyclus van modellen beheren, stel dan models.providers.lmstudio.params.preload: false in. Zie /providers/lmstudio voor installatie en probleemoplossing.

Ollama

Ollama wordt geleverd als gebundelde provider-Plugin en gebruikt Ollama’s native API:

Provider: ollama
Auth: niet vereist (lokale server)
Voorbeeldmodel: ollama/llama3.3
Installatie: https://ollama.com/download

# Installeer Ollama en haal daarna 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 je aanmeldt 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 gebundelde provider-Plugin voor lokale/zelfgehoste OpenAI-compatibele servers:

Provider: vllm
Auth: optioneel (afhankelijk van je server)
Standaard basis-URL: http://127.0.0.1:8000/v1

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

export VLLM_API_KEY="vllm-local"

Stel daarna 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 gebundelde provider-Plugin voor snelle, zelfgehoste OpenAI-compatibele servers:

Provider: sglang
Auth: optioneel (afhankelijk van je server)
Standaard basis-URL: http://127.0.0.1:30000/v1

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

export SGLANG_API_KEY="sglang-local"

Stel daarna 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,
          },
        ],
      },
    },
  },
}

Standaard optionele velden

Voor aangepaste providers zijn reasoning, input, cost, contextWindow en maxTokens optioneel. Wanneer ze worden weggelaten, gebruikt OpenClaw standaard:

reasoning: false
input: ["text"]
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }
contextWindow: 200000
maxTokens: 8192

Aanbevolen: stel expliciete waarden in die overeenkomen met de limieten van je proxy/model.

Regels voor proxyroute-vormgeving

Voor api: "openai-completions" op niet-native endpoints (elke niet-lege baseUrl waarvan de host niet api.openai.com is), dwingt OpenClaw compat.supportsDeveloperRole: false af om provider-400-fouten voor niet-ondersteunde developer-rollen te voorkomen.
Proxy-achtige OpenAI-compatibele routes slaan ook native, alleen-OpenAI-requestvorming over: geen service_tier, geen Responses store, geen Completions store, geen promptcache-hints, geen OpenAI reasoning-compat payloadvorming en geen verborgen OpenClaw-attributieheaders.
Voor OpenAI-compatibele Completions-proxy’s die leveranciersspecifieke velden nodig hebben, stel je agents.defaults.models["provider/model"].params.extra_body (of extraBody) in om extra JSON samen te voegen in de uitgaande requestbody.
Voor vLLM-chattemplatebesturing stel je agents.defaults.models["provider/model"].params.chat_template_kwargs in. De gebundelde vLLM-Plugin verzendt automatisch enable_thinking: false en force_nonempty_content: true voor vllm/nemotron-3-* wanneer het denkniveau van de sessie uit staat.
Voor trage lokale modellen of externe LAN-/tailnet-hosts stel je models.providers.<id>.timeoutSeconds in. Dit verlengt de afhandeling van HTTP-verzoeken naar provider-modellen, inclusief verbinden, headers, bodystreaming en de totale bewaakte-fetch-afbreking, zonder de runtime-time-out van de hele agent te verhogen. Als agents.defaults.timeoutSeconds of een runspecifieke time-out lager is, verhoog dan ook die bovengrens; provider-time-outs kunnen de volledige run niet verlengen.
HTTP-aanroepen naar modelproviders staan fake-IP-DNS-antwoorden van Surge, Clash en sing-box in 198.18.0.0/15 en fc00::/7 alleen toe voor de geconfigureerde provider-baseUrl-hostnaam. Aangepaste/lokale providerendpoints vertrouwen ook exact die geconfigureerde scheme://host:port-oorsprong voor bewaakte modelverzoeken, inclusief loopback-, LAN- en tailnet-hosts. Dit is geen nieuwe configuratieoptie; de baseUrl die je configureert, breidt het requestbeleid alleen uit voor die oorsprong. Toestaan van fake-IP-hostnamen en exact-origin-vertrouwen zijn onafhankelijke mechanismen. Andere privé-, loopback-, link-local-, metadatabestemmingen en andere poorten vereisen nog steeds een expliciete opt-in met models.providers.<id>.request.allowPrivateNetwork: true. Stel models.providers.<id>.request.allowPrivateNetwork: false in om exact-origin-vertrouwen uit te schakelen.
Als baseUrl leeg/weggelaten is, behoudt OpenClaw het standaard OpenAI-gedrag (dat naar api.openai.com resolveert).
Om veiligheidsredenen wordt een expliciete compat.supportsDeveloperRole: true nog steeds overschreven op niet-native openai-completions-endpoints.
Voor api: "anthropic-messages" op niet-directe endpoints (elke provider behalve canonieke anthropic, of een aangepaste models.providers.anthropic.baseUrl waarvan de host geen openbaar api.anthropic.com-endpoint is), onderdrukt OpenClaw impliciete Anthropic-bètaheaders zoals claude-code-20250219, interleaved-thinking-2025-05-14 en OAuth-markeringen, zodat aangepaste Anthropic-compatibele proxy’s niet-ondersteunde bètaflags niet weigeren. Stel models.providers.<id>.headers["anthropic-beta"] expliciet in als je proxy specifieke bètafuncties nodig heeft.

CLI-voorbeelden

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

Zie ook: Configuratie voor volledige configuratievoorbeelden.

Gerelateerd

Configuratiereferentie - modelconfiguratiesleutels
Modelfailover - fallbackketens en retrygedrag
Modellen - modelconfiguratie en aliassen
Providers - installatiegidsen per provider

​Snelle regels

​Providergedrag in eigendom van Plugins

​API-sleutelrotatie

​Officiële provider-Plugins

​OpenAI

​Anthropic

​OpenAI ChatGPT/Codex OAuth

​Andere gehoste opties in abonnementsstijl

Z.AI (GLM)

MiniMax

Qwen Cloud

​OpenCode

​Google Gemini (API-sleutel)

​Google Vertex en Gemini CLI

​Z.AI (GLM)

​Vercel AI Gateway

​Andere gebundelde provider-Plugins

​Bijzonderheden die nuttig zijn om te weten

​Providers via models.providers (aangepaste/base-URL)

​Moonshot AI (Kimi)

​Kimi-coderen

​Volcano Engine (Doubao)

​BytePlus (internationaal)

​Synthetic

​MiniMax

​LM Studio

​Ollama

​vLLM

​SGLang

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

​CLI-voorbeelden

​Gerelateerd

Snelle regels

Providergedrag in eigendom van Plugins

API-sleutelrotatie

Officiële provider-Plugins

OpenAI

Anthropic

OpenAI ChatGPT/Codex OAuth

Andere gehoste opties in abonnementsstijl

OpenCode

Google Gemini (API-sleutel)

Google Vertex en Gemini CLI

Z.AI (GLM)

Vercel AI Gateway

Andere gebundelde provider-Plugins

Bijzonderheden die nuttig zijn om te weten

Providers via `models.providers` (aangepaste/base-URL)

Moonshot AI (Kimi)

Kimi-coderen

Volcano Engine (Doubao)

BytePlus (internationaal)

Synthetic

MiniMax

LM Studio

Ollama

vLLM

SGLang

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

CLI-voorbeelden

Gerelateerd