Modelproviders

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

# Snelle regels

# Plugin-eigen providergedrag

De meeste providerspecifieke logica staat in provider-plugins (registerProvider(...)), terwijl OpenClaw de generieke inferentielus behoudt. Plugins zijn eigenaar van onboarding, modelcatalogi, auth env-var mapping, transport/config-normalisatie, tool-schema-opschoning, failover-classificatie, OAuth-verversing, gebruiksrapportage, thinking/reasoning-profielen en meer.

De volledige lijst met provider-SDK hooks en voorbeelden van meegeleverde plugins staat in Provider-plugins. Een provider die een volledig aangepaste request-executor nodig heeft, is een afzonderlijk, dieper uitbreidingsoppervlak.

# API-key rotatie

# Ingebouwde providers (pi-ai-catalogus)

OpenClaw wordt geleverd met de pi-ai-catalogus. Deze providers vereisen geen models.providers-config; stel alleen auth in en kies een model.

# 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-key zich anders gedraagt.
• CLI: openclaw onboard --auth-choice openai-api-key
• Standaardtransport is auto (WebSocket eerst, SSE als fallback)
• Overschrijf per model via agents.defaults.models["openai/<model>"].params.transport ("sse", "websocket" of "auto")
• OpenAI Responses WebSocket warm-up staat standaard aan via params.openaiWsWarmup (true/false)
• 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 tier 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 proxies
• Native OpenAI-routes behouden ook Responses store, prompt-cache hints en OpenAI reasoning-compat payload-vormgeving; proxy-routes doen dat niet
• openai/gpt-5.3-codex-spark wordt bewust onderdrukt in OpenClaw omdat live OpenAI API-requests dit afwijzen en de huidige Codex-catalogus het niet beschikbaar stelt

{
  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-key en OAuth-geauthenticeerd verkeer dat naar api.anthropic.com wordt verzonden; OpenClaw mapt dat naar Anthropic service_tier (auto versus standard_only)
• Aanbevolen Claude CLI-config houdt de modelreferentie canoniek en selecteert de CLI backend afzonderlijk: anthropic/claude-opus-4-7 met agents.defaults.agentRuntime.id: "claude-cli". Legacy claude-cli/claude-opus-4-7-referenties blijven werken voor compatibiliteit.

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

# OpenAI Codex OAuth

• Provider: openai-codex
• Auth: OAuth (ChatGPT)
• PI-modelreferentie: openai-codex/gpt-5.5
• Native Codex app-server harness-referentie: openai/gpt-5.5 met agents.defaults.agentRuntime.id: "codex"
• Native Codex app-server harness-docs: Codex harness
• Legacy modelreferenties: codex/gpt-*
• Plugin-grens: openai-codex/* laadt de OpenAI-plugin; de native Codex app-server plugin wordt alleen geselecteerd door de Codex harness-runtime of legacy codex/*-referenties.
• CLI: openclaw onboard --auth-choice openai-codex of openclaw models auth login --provider openai-codex
• Standaardtransport is auto (WebSocket eerst, SSE als fallback)
• Overschrijf per PI-model via agents.defaults.models["openai-codex/<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 proxies
• Deelt dezelfde /fast-schakelaar en params.fastMode-config als direct openai/*; OpenClaw mapt dat naar service_tier=priority
• openai-codex/gpt-5.5 gebruikt de native Codex-catalogus contextWindow = 400000 en standaardruntime contextTokens = 272000; overschrijf de runtimelimiet met models.providers.openai-codex.models[].contextTokens
• Beleidsnotitie: OpenAI Codex OAuth wordt expliciet ondersteund voor externe tools/workflows zoals OpenClaw.
• Voor de gebruikelijke abonnementsroute plus native Codex-runtime meld je je aan met openai-codex auth, maar configureer je openai/gpt-5.5 plus agents.defaults.agentRuntime.id: "codex".
• Gebruik openai-codex/gpt-5.5 alleen wanneer je de Codex OAuth/abonnementsroute via PI wilt; gebruik openai/gpt-5.5 zonder de Codex runtime-overschrijving wanneer je API-key setup en lokale catalogus de publieke API-route beschikbaar stellen.
• Oudere openai-codex/gpt-5.1*, openai-codex/gpt-5.2* en openai-codex/gpt-5.3*-referenties worden onderdrukt omdat ChatGPT/Codex OAuth-accounts ze afwijzen; gebruik in plaats daarvan openai-codex/gpt-5.5 of de native Codex-runtime route.

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

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

# Andere gehoste opties in abonnementsstijl

# OpenCode

• Auth: OPENCODE_API_KEY (of OPENCODE_ZEN_API_KEY)
• Zen runtime-provider: opencode
• Go runtime-provider: 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-key)

• Aanbieder: 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 dynamisch denken. Gemini 3/3.1 laten een vaste thinkingLevel weg; Gemini 2.5 verzendt thinkingBudget: -1.
• Directe Gemini-uitvoeringen accepteren ook agents.defaults.models["google/<model>"].params.cachedContent (of verouderd cached_content) om een providernatieve cachedContents/...-handle door te geven; Gemini-cachehits verschijnen als OpenClaw cacheRead

# Google Vertex en Gemini CLI

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

Gemini CLI OAuth wordt meegeleverd 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 JSON-antwoorden worden geparseerd uit response; gebruik valt terug op stats, waarbij stats.cached wordt genormaliseerd naar OpenClaw cacheRead.

# Z.AI (GLM)

• Aanbieder: zai
• Authenticatie: ZAI_API_KEY
• Voorbeeldmodel: zai/glm-5.1
• CLI: openclaw onboard --auth-choice zai-api-key
  • Aliassen: z.ai/* en z-ai/* worden genormaliseerd naar zai/*
  • zai-api-key detecteert automatisch het bijpassende Z.AI-eindpunt; zai-coding-global, zai-coding-cn, zai-global en zai-cn dwingen een specifiek oppervlak af

# Vercel AI Gateway

• Aanbieder: 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

# Kilo Gateway

• Aanbieder: kilocode
• Authenticatie: KILOCODE_API_KEY
• Voorbeeldmodel: kilocode/kilo/auto
• CLI: openclaw onboard --auth-choice kilocode-api-key
• Basis-URL: https://api.kilo.ai/api/gateway/
• De statische fallbackcatalogus levert kilocode/kilo/auto; live https://api.kilo.ai/api/gateway/models-detectie kan de runtimecatalogus verder uitbreiden.
• Exacte upstream-routering achter kilocode/kilo/auto is eigendom van Kilo Gateway, niet hardgecodeerd in OpenClaw.

Zie /providers/kilocode voor installatiedetails.

# Andere gebundelde provider-Plugins

# Bijzonderheden die goed zijn om te weten

# 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 meegeleverde provider-Plugins hieronder publiceren al een standaardcatalogus. Gebruik expliciete models.providers.<id>-vermeldingen alleen wanneer je de standaard basis-URL, headers of modellijst wilt overschrijven.

Gateway-modelcapaciteitscontroles lezen ook expliciete metadata uit models.providers.<id>.models[]. Als een aangepast of proxymodel afbeeldingen accepteert, stel dan input: ["text", "image"] in voor dat model, zodat WebChat en bijlagenpaden met node-oorsprong afbeeldingen doorgeven als native modelinputs in plaats van mediarefs voor alleen tekst.

# Moonshot AI (Kimi)

Moonshot wordt geleverd als een meegeleverde provider-Plugin. Gebruik standaard de ingebouwde provider en 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.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-codering

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

• Provider: kimi
• Auth: KIMI_API_KEY
• Voorbeeldmodel: kimi/kimi-code

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

Legacy kimi/k2p5 blijft geaccepteerd als compatibiliteitsmodel-id.

# Volcano Engine (Doubao)

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

• Provider: volcengine (codering: 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 coderingsoppervlak, maar de algemene volcengine/*-catalogus wordt tegelijk geregistreerd.

In onboarding-/configure-modelkiezers 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 provider-gescopeerde kiezer te tonen.

# BytePlus (Internationaal)

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

• Provider: byteplus (codering: 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" } },
  },
}

Onboarding gebruikt standaard het coderingsoppervlak, maar de algemene byteplus/*-catalogus wordt tegelijk geregistreerd.

In onboarding-/configure-modelkiezers geeft de BytePlus-authenticatiekeuze 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-gescopeerde kiezer te tonen.

# Synthetic

Synthetic biedt Anthropic-compatibele modellen achter de synthetic-provider:

• Provider: synthetic
• Authenticatie: 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 (wereldwijd): --auth-choice minimax-global-oauth
• MiniMax OAuth (CN): --auth-choice minimax-cn-oauth
• MiniMax API key (wereldwijd): --auth-choice minimax-global-api
• MiniMax API key (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.

Plugin-eigen capability-splitsing:

• Standaardinstellingen voor tekst/chat blijven op minimax/MiniMax-M2.7
• Afbeeldingsgeneratie is minimax/image-01 of minimax-portal/image-01
• Afbeeldingsbegrip is Plugin-eigen MiniMax-VL-01 op beide MiniMax-authenticatiepaden
• Webzoeken blijft op provider-id minimax

# LM Studio

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

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

Stel daarna een model in (vervang door een van de id's die worden teruggegeven door http://localhost:1234/api/v1/models):

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

OpenClaw gebruikt LM Studio's native /api/v1/models en /api/v1/models/load voor ontdekking en automatisch laden, met standaard /v1/chat/completions voor inferentie. Als je wilt dat LM Studio JIT-laden, TTL en automatisch verwijderen de modellevenscyclus beheren, stel dan 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 Ollama's native API:

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

# Install Ollama, then pull a model:
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 een gebundelde provider-Plugin voor lokale/zelfgehoste OpenAI-compatibele servers:

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

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

export VLLM_API_KEY="vllm-local"

Stel daarna een model in (vervang door een van de id's die worden teruggegeven door /v1/models):

{
  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)
• Standaard basis-URL: http://127.0.0.1:30000/v1

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

export SGLANG_API_KEY="sglang-local"

Stel daarna een model in (vervang door een van de id's die worden teruggegeven door /v1/models):

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

Zie /providers/sglang voor details.

# Lokale proxies (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-zen
openclaw models set opencode/claude-opus-4-6
openclaw models list

Zie ook: Configuratie voor volledige configuratievoorbeelden.

# Gerelateerd

• Configuratiereferentie - modelconfiguratiesleutels
• Modelfailover - fallbackketens en retry-gedrag
• Modellen - modelconfiguratie en aliassen
• Providers - installatiegidsen per provider