> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Modelproviders Referentie voor **LLM-/modelproviders** (niet chatkanalen zoals WhatsApp/Telegram). Zie [Modellen](/nl/concepts/models) voor regels voor modelselectie. ## Snelle regels * 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 `. * `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](/nl/concepts/model-failover). `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 ` of `openclaw models auth login --provider --set-default` om het standaardmodel bewust te wisselen. OpenAI-familieroutes zijn prefixspecifiek: * `openai/` 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/`. * `openai/` plus provider/model `agentRuntime.id: "openclaw"` gebruikt de ingebouwde runtime van OpenClaw voor expliciete API-sleutel- of compatibiliteitsroutes. Zie [OpenAI](/nl/providers/openai) en [Codex-harness](/nl/plugins/codex-harness). Als de provider/runtime-scheiding verwarrend is, lees dan eerst [Agent-runtimes](/nl/concepts/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/`-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 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](/nl/plugins/sdk-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 Configureer meerdere sleutels via: * `OPENCLAW_LIVE__KEY` (enkele live-overschrijving, hoogste prioriteit) * `_API_KEYS` (lijst met komma's of puntkomma's) * `_API_KEY` (primaire sleutel) * `_API_KEY_*` (genummerde lijst, bijvoorbeeld `_API_KEY_1`) Voor Google-providers wordt `GOOGLE_API_KEY` ook meegenomen als fallback. De sleutelselectievolgorde behoudt prioriteit en dedupliceert waarden. * 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/"].params.transport` (`"sse"`, `"websocket"` of `"auto"`) * OpenAI-prioriteitsverwerking kan worden ingeschakeld via `agents.defaults.models["openai/"].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 ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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. ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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](/nl/plugins/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/"].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. ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { plugins: { entries: { codex: { enabled: true } } }, agents: { defaults: { model: { primary: "openai/gpt-5.5" }, }, }, } ``` ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { models: { providers: { openai: { models: [{ id: "gpt-5.5", contextTokens: 160000 }], }, }, }, } ``` ### Andere gehoste opties in abonnementsstijl Z.AI Coding Plan of algemene API-eindpunten. MiniMax Coding Plan OAuth of toegang met API-sleutel. 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` ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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/"].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. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} brew install gemini-cli ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} npm install -g @google/gemini-cli ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw plugins enable google ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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. 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](/nl/providers/ollama-cloud) | `ollama-cloud` | `OLLAMA_API_KEY` | `ollama-cloud/kimi-k2.6` | | OpenRouter | `openrouter` | OpenRouter OAuth of `OPENROUTER_API_KEY` | `openrouter/auto` | | [Qwen OAuth](/nl/providers/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 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. Gemini-ondersteunde refs volgen hetzelfde proxy-Gemini-opschoningspad; `kilocode/kilo/auto` en andere refs zonder ondersteuning voor proxy-redeneren slaan proxy-reasoning-injectie over. API-key-onboarding schrijft expliciete M3- en M2.7-chatmodeldefinities; afbeeldingsbegrip blijft op de Plugin-owned `MiniMax-VL-01`-mediaprovider. Model-ID's gebruiken een `nvidia//`-namespace (bijvoorbeeld `nvidia/nvidia/nemotron-...` naast `nvidia/moonshotai/kimi-k2.5`); pickers behouden de letterlijke `/`-samenstelling terwijl de canonieke sleutel die naar de API wordt verzonden enkelvoudig geprefixt blijft. 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/"].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.`-vermeldingen alleen wanneer je de standaardbasis-URL, headers of modellenlijst wilt overschrijven. Gateway-controles voor modelmogelijkheden lezen ook expliciete `models.providers..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..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-model-refs:start" * `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` [//]: # "moonshot-kimi-k2-model-refs:end" ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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` ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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` ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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. * `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` ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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. * `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` ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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](/nl/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): ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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](/nl/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](https://ollama.com/download) ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # Installeer Ollama en haal daarna een model op: ollama pull llama3.3 ``` ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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](/nl/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): ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} export VLLM_API_KEY="vllm-local" ``` Stel daarna een model in (vervang dit door een van de ID's die `/v1/models` retourneert): ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { agents: { defaults: { model: { primary: "vllm/your-model-id" } }, }, } ``` Zie [/providers/vllm](/nl/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): ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} export SGLANG_API_KEY="sglang-local" ``` Stel daarna een model in (vervang dit door een van de ID's die `/v1/models` retourneert): ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { agents: { defaults: { model: { primary: "sglang/your-model-id" } }, }, } ``` Zie [/providers/sglang](/nl/providers/sglang) voor details. ### Lokale proxy's (LM Studio, vLLM, LiteLLM, enz.) Voorbeeld (OpenAI-compatibel): ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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, }, ], }, }, }, } ``` 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. * 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..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..request.allowPrivateNetwork: true`. Stel `models.providers..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..headers["anthropic-beta"]` expliciet in als je proxy specifieke bètafuncties nodig heeft. ## CLI-voorbeelden ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --auth-choice opencode-zen openclaw models set opencode/claude-opus-4-6 openclaw models list ``` Zie ook: [Configuratie](/nl/gateway/configuration) voor volledige configuratievoorbeelden. ## Gerelateerd * [Configuratiereferentie](/nl/gateway/config-agents#agent-defaults) - modelconfiguratiesleutels * [Modelfailover](/nl/concepts/model-failover) - fallbackketens en retrygedrag * [Modellen](/nl/concepts/models) - modelconfiguratie en aliassen * [Providers](/nl/providers) - installatiegidsen per provider