--- read_when: - Configureren van `tools.*`-beleid, allowlists of experimentele functies - Aangepaste providers registreren of basis-URL's overschrijven - OpenAI-compatibele zelfgehoste endpoints instellen sidebarTitle: Tools and custom providers summary: Hulpmiddelenconfiguratie (beleid, experimentele schakelaars, door providers ondersteunde hulpmiddelen) en instelling van aangepaste provider/basis-URL title: Configuratie — hulpmiddelen en aangepaste aanbieders x-i18n: generated_at: "2026-05-11T20:30:03Z" model: gpt-5.5 provider: openai source_hash: c9ab0ec823da1e2e8598d9efb998a207c4486ba82dcf4dd65422c6bf90581b46 source_path: gateway/config-tools.md workflow: 16 --- `tools.*`-configuratiesleutels en aangepaste provider- / basis-URL-configuratie. Zie voor agents, kanalen en andere configuratiesleutels op topniveau de [Configuratiereferentie](/nl/gateway/configuration-reference). ## Hulpmiddelen ### Hulpmiddelprofielen `tools.profile` stelt een basis-allowlist in vóór `tools.allow`/`tools.deny`: Lokale onboarding zet nieuwe lokale configuraties standaard op `tools.profile: "coding"` wanneer dit niet is ingesteld (bestaande expliciete profielen blijven behouden). | Profiel | Omvat | | ----------- | ------------------------------------------------------------------------------------------------------------------------------ | | `minimal` | alleen `session_status` | | `coding` | `group:fs`, `group:runtime`, `group:web`, `group:sessions`, `group:memory`, `cron`, `image`, `image_generate`, `video_generate` | | `messaging` | `group:messaging`, `sessions_list`, `sessions_history`, `sessions_send`, `session_status` | | `full` | Geen beperking (hetzelfde als niet ingesteld) | ### Hulpmiddelgroepen | Groep | Hulpmiddelen | | ------------------ | ---------------------------------------------------------------------------------------------------------------------- | | `group:runtime` | `exec`, `process`, `code_execution` (`bash` wordt geaccepteerd als alias voor `exec`) | | `group:fs` | `read`, `write`, `edit`, `apply_patch` | | `group:sessions` | `sessions_list`, `sessions_history`, `sessions_send`, `sessions_spawn`, `sessions_yield`, `subagents`, `session_status` | | `group:memory` | `memory_search`, `memory_get` | | `group:web` | `web_search`, `x_search`, `web_fetch` | | `group:ui` | `browser`, `canvas` | | `group:automation` | `heartbeat_respond`, `cron`, `gateway` | | `group:messaging` | `message` | | `group:nodes` | `nodes` | | `group:agents` | `agents_list`, `update_plan` | | `group:media` | `image`, `image_generate`, `music_generate`, `video_generate`, `tts` | | `group:openclaw` | Alle ingebouwde hulpmiddelen (exclusief provider-plugins) | ### `tools.allow` / `tools.deny` Globaal allow/deny-beleid voor hulpmiddelen (deny wint). Hoofdletterongevoelig, ondersteunt `*`-wildcards. Wordt ook toegepast wanneer de Docker-sandbox uit staat. ```json5 { tools: { deny: ["browser", "canvas"] }, } ``` `write` en `apply_patch` zijn afzonderlijke hulpmiddel-id’s. `allow: ["write"]` schakelt ook `apply_patch` in voor compatibele modellen, maar `deny: ["write"]` weigert `apply_patch` niet. Weiger `group:fs` of vermeld elk muterend hulpmiddel expliciet om alle bestandsmutaties te blokkeren: ```json5 { tools: { deny: ["write", "edit", "apply_patch"] }, } ``` ### `tools.byProvider` Beperk hulpmiddelen verder voor specifieke providers of modellen. Volgorde: basisprofiel → providerprofiel → allow/deny. ```json5 { tools: { profile: "coding", byProvider: { "google-antigravity": { profile: "minimal" }, "openai/gpt-5.4": { allow: ["group:fs", "sessions_list"] }, }, }, } ``` ### `tools.toolsBySender` Beperkt hulpmiddelen voor een specifieke aanvrageridentiteit. Dit is defense-in-depth bovenop toegangscontrole voor kanalen; sender-waarden moeten uit de kanaaladapter komen, niet uit berichttekst. ```json5 { tools: { toolsBySender: { "channel:discord:1234567890123": { alsoAllow: ["group:fs"] }, "id:guest-user-id": { deny: ["group:runtime", "group:fs"] }, "*": { deny: ["exec", "process", "write", "edit", "apply_patch"] }, }, }, } ``` Sleutels gebruiken expliciete voorvoegsels: `channel::`, `id:`, `e164:`, `username:`, `name:`, of `"*"`. Kanaal-id’s zijn canonieke OpenClaw-id’s; aliassen zoals `teams` normaliseren naar `msteams`. Verouderde sleutels zonder voorvoegsel worden alleen als `id:` geaccepteerd. De matchvolgorde is channel+id, id, e164, username, name en daarna wildcard. Per-agent `agents.list[].tools.toolsBySender` overschrijft de globale sender-match wanneer die overeenkomt, zelfs met een leeg `{}`-beleid. ### `tools.elevated` Regelt verhoogde `exec`-toegang buiten de sandbox: ```json5 { tools: { elevated: { enabled: true, allowFrom: { whatsapp: ["+15555550123"], discord: ["1234567890123", "987654321098765432"], }, }, }, } ``` - Per-agent override (`agents.list[].tools.elevated`) kan alleen verder beperken. - `/elevated on|off|ask|full` slaat de status per sessie op; inline directives gelden voor één bericht. - Verhoogde `exec` omzeilt sandboxing en gebruikt het geconfigureerde escape-pad (standaard `gateway`, of `node` wanneer het exec-doel `node` is). ### `tools.exec` ```json5 { tools: { exec: { backgroundMs: 10000, timeoutSec: 1800, cleanupMs: 1800000, notifyOnExit: true, notifyOnExitEmptySuccess: false, commandHighlighting: false, applyPatch: { enabled: false, allowModels: ["gpt-5.5"], }, }, }, } ``` ### `tools.loopDetection` Tool-loop-veiligheidscontroles zijn **standaard uitgeschakeld**. Stel `enabled: true` in om detectie te activeren. Instellingen kunnen globaal worden gedefinieerd in `tools.loopDetection` en per agent worden overschreven via `agents.list[].tools.loopDetection`. ```json5 { tools: { loopDetection: { enabled: true, historySize: 30, warningThreshold: 10, criticalThreshold: 20, globalCircuitBreakerThreshold: 30, detectors: { genericRepeat: true, knownPollNoProgress: true, pingPong: true, }, }, }, } ``` Maximaal bewaarde tool-call-geschiedenis voor loopanalyse. Drempel voor herhalende patronen zonder voortgang voor waarschuwingen. Hogere herhalingsdrempel voor het blokkeren van kritieke loops. Harde stopdrempel voor elke run zonder voortgang. Waarschuw bij herhaalde aanroepen met dezelfde tool/dezelfde argumenten. Waarschuw/blokkeer bij bekende poll-tools (`process.poll`, `command_status`, enz.). Waarschuw/blokkeer bij afwisselende paarpatronen zonder voortgang. Als `warningThreshold >= criticalThreshold` of `criticalThreshold >= globalCircuitBreakerThreshold`, mislukt de validatie. ### `tools.web` ```json5 { tools: { web: { search: { enabled: true, apiKey: "brave_api_key", // or BRAVE_API_KEY env maxResults: 5, timeoutSeconds: 30, cacheTtlMinutes: 15, }, fetch: { enabled: true, provider: "firecrawl", // optional; omit for auto-detect maxChars: 50000, maxCharsCap: 50000, maxResponseBytes: 2000000, timeoutSeconds: 30, cacheTtlMinutes: 15, maxRedirects: 3, readability: true, userAgent: "custom-ua", }, }, }, } ``` ### `tools.media` Configureert begrip van inkomende media (afbeelding/audio/video): ```json5 { tools: { media: { concurrency: 2, asyncCompletion: { directSend: false, // deprecated: completions stay agent-mediated }, audio: { enabled: true, maxBytes: 20971520, scope: { default: "deny", rules: [{ action: "allow", match: { chatType: "direct" } }], }, models: [ { provider: "openai", model: "gpt-4o-mini-transcribe" }, { type: "cli", command: "whisper", args: ["--model", "base", "{{MediaPath}}"] }, ], }, image: { enabled: true, timeoutSeconds: 180, models: [{ provider: "ollama", model: "gemma4:26b", timeoutSeconds: 300 }], }, video: { enabled: true, maxBytes: 52428800, models: [{ provider: "google", model: "gemini-3-flash-preview" }], }, }, }, } ``` **Provider-vermelding** (`type: "provider"` of weggelaten): - `provider`: API-provider-id (`openai`, `anthropic`, `google`/`gemini`, `groq`, enz.) - `model`: overschrijving van model-id - `profile` / `preferredProfile`: profielselectie in `auth-profiles.json` **CLI-vermelding** (`type: "cli"`): - `command`: uitvoerbaar bestand om uit te voeren - `args`: getemplate argumenten (ondersteunt `{{MediaPath}}`, `{{Prompt}}`, `{{MaxChars}}`, enz.; `openclaw doctor --fix` migreert verouderde `{input}`-placeholders naar `{{MediaPath}}`) **Algemene velden:** - `capabilities`: optionele lijst (`image`, `audio`, `video`). Standaarden: `openai`/`anthropic`/`minimax` → afbeelding, `google` → afbeelding+audio+video, `groq` → audio. - `prompt`, `maxChars`, `maxBytes`, `timeoutSeconds`, `language`: overschrijvingen per vermelding. - `tools.media.image.timeoutSeconds` en overeenkomende `timeoutSeconds`-vermeldingen voor afbeeldingsmodellen zijn ook van toepassing wanneer de agent de expliciete `image`-tool aanroept. - Mislukkingen vallen terug op de volgende vermelding. Provider-authenticatie volgt de standaardvolgorde: `auth-profiles.json` → env-vars → `models.providers.*.apiKey`. **Velden voor asynchrone voltooiing:** - `asyncCompletion.directSend`: verouderde compatibiliteitsvlag. Voltooide asynchrone mediataken blijven via de sessie van de aanvrager bemiddeld, zodat de agent het resultaat ontvangt, beslist hoe de gebruiker wordt geïnformeerd en de berichtentool gebruikt wanneer bezorging via de bron dat vereist. ### `tools.agentToAgent` ```json5 { tools: { agentToAgent: { enabled: false, allow: ["home", "work"], }, }, } ``` ### `tools.sessions` Bepaalt welke sessies kunnen worden gericht door de sessietools (`sessions_list`, `sessions_history`, `sessions_send`). Standaard: `tree` (huidige sessie + sessies die daardoor zijn gespawnd, zoals subagents). ```json5 { tools: { sessions: { // "self" | "tree" | "agent" | "all" visibility: "tree", }, }, } ``` - `self`: alleen de huidige sessiesleutel. - `tree`: huidige sessie + sessies die door de huidige sessie zijn gespawnd (subagents). - `agent`: elke sessie die bij de huidige agent-id hoort (kan andere gebruikers omvatten als je per-afzender-sessies onder dezelfde agent-id uitvoert). - `all`: elke sessie. Richten op andere agents vereist nog steeds `tools.agentToAgent`. - Sandbox-beperking: wanneer de huidige sessie in een sandbox draait en `agents.defaults.sandbox.sessionToolsVisibility="spawned"`, wordt zichtbaarheid geforceerd naar `tree`, zelfs als `tools.sessions.visibility="all"`. ### `tools.sessions_spawn` Bepaalt inline-bijlageondersteuning voor `sessions_spawn`. ```json5 { tools: { sessions_spawn: { attachments: { enabled: false, // opt-in: set true to allow inline file attachments maxTotalBytes: 5242880, // 5 MB total across all files maxFiles: 50, maxFileBytes: 1048576, // 1 MB per file retainOnSessionKeep: false, // keep attachments when cleanup="keep" }, }, }, } ``` - Bijlagen worden alleen ondersteund voor `runtime: "subagent"`. ACP-runtime weigert ze. - Bestanden worden in de child-werkruimte gematerialiseerd op `.openclaw/attachments//` met een `.manifest.json`. - Bijlage-inhoud wordt automatisch geredigeerd uit transcriptpersistentie. - Base64-invoer wordt gevalideerd met strikte controles op alfabet/opvulling en een groottebeveiliging vóór decodering. - Bestandsmachtigingen zijn `0700` voor mappen en `0600` voor bestanden. - Opschoning volgt het `cleanup`-beleid: `delete` verwijdert bijlagen altijd; `keep` behoudt ze alleen wanneer `retainOnSessionKeep: true`. ### `tools.experimental` Experimentele ingebouwde toolvlaggen. Standaard uit, tenzij een strict-agentic GPT-5-regel voor automatisch inschakelen van toepassing is. ```json5 { tools: { experimental: { planTool: true, // enable experimental update_plan }, }, } ``` - `planTool`: schakelt de gestructureerde `update_plan`-tool in voor het bijhouden van niet-triviaal meerstapswerk. - Standaard: `false`, tenzij `agents.defaults.embeddedPi.executionContract` (of een override per agent) is ingesteld op `"strict-agentic"` voor een OpenAI- of OpenAI Codex-run uit de GPT-5-familie. Stel in op `true` om de tool buiten dat bereik geforceerd in te schakelen, of op `false` om deze zelfs voor strict-agentic GPT-5-runs uitgeschakeld te houden. - Wanneer ingeschakeld, voegt de systeemprompt ook gebruiksrichtlijnen toe, zodat het model de tool alleen voor substantieel werk gebruikt en maximaal één stap op `in_progress` houdt. ### `agents.defaults.subagents` ```json5 { agents: { defaults: { subagents: { allowAgents: ["research"], model: "minimax/MiniMax-M2.7", maxConcurrent: 8, runTimeoutSeconds: 900, announceTimeoutMs: 120000, archiveAfterMinutes: 60, }, }, }, } ``` - `model`: standaardmodel voor gestarte subagenten. Indien weggelaten, erven subagenten het model van de aanroeper. - `allowAgents`: standaardtoelatingslijst van doelagent-id's voor `sessions_spawn` wanneer de aanvragende agent geen eigen `subagents.allowAgents` instelt (`["*"]` = elke; standaard: alleen dezelfde agent). - `runTimeoutSeconds`: standaardtime-out (seconden) voor `sessions_spawn` wanneer de toolaanroep `runTimeoutSeconds` weglaat. `0` betekent geen time-out. - `announceTimeoutMs`: time-out per aanroep (milliseconden) voor pogingen tot aflevering van Gateway-`agent`-aankondigingen. Standaard: `120000`. Tijdelijke herhalingspogingen kunnen ervoor zorgen dat de totale wachttijd voor aankondigingen langer is dan één geconfigureerde time-out. - Toolbeleid per subagent: `tools.subagents.tools.allow` / `tools.subagents.tools.deny`. --- ## Aangepaste providers en basis-URL's OpenClaw gebruikt de ingebouwde modelcatalogus. Voeg aangepaste providers toe via `models.providers` in config of `~/.openclaw/agents//agent/models.json`. ```json5 { models: { mode: "merge", // merge (default) | replace providers: { "custom-proxy": { baseUrl: "http://localhost:4000/v1", apiKey: "LITELLM_KEY", api: "openai-completions", // openai-completions | openai-responses | anthropic-messages | google-generative-ai models: [ { id: "llama-3.1-8b", name: "Llama 3.1 8B", reasoning: false, input: ["text"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 128000, contextTokens: 96000, maxTokens: 32000, }, ], }, }, }, } ``` - Gebruik `authHeader: true` + `headers` voor aangepaste authenticatiebehoeften. - Overschrijf de root van de agentconfig met `OPENCLAW_AGENT_DIR` (of `PI_CODING_AGENT_DIR`, een alias voor een verouderde omgevingsvariabele). - Samenvoegingsvoorrang voor overeenkomende provider-ID's: - Niet-lege `baseUrl`-waarden in agent-`models.json` winnen. - Niet-lege `apiKey`-waarden van de agent winnen alleen wanneer die provider niet door SecretRef wordt beheerd in de huidige config-/auth-profielcontext. - Door SecretRef beheerde provider-`apiKey`-waarden worden vernieuwd vanuit bronmarkeringen (`ENV_VAR_NAME` voor env-verwijzingen, `secretref-managed` voor bestand-/exec-verwijzingen) in plaats van opgeloste geheimen te bewaren. - Door SecretRef beheerde provider-headerwaarden worden vernieuwd vanuit bronmarkeringen (`secretref-env:ENV_VAR_NAME` voor env-verwijzingen, `secretref-managed` voor bestand-/exec-verwijzingen). - Lege of ontbrekende agent-`apiKey`/`baseUrl` vallen terug op `models.providers` in config. - Overeenkomende model-`contextWindow`/`maxTokens` gebruiken de hogere waarde van expliciete config en impliciete cataloguswaarden. - Overeenkomende model-`contextTokens` behouden een expliciete runtime-limiet wanneer aanwezig; gebruik dit om de effectieve context te beperken zonder de native modelmetadata te wijzigen. - Gebruik `models.mode: "replace"` wanneer je wilt dat config `models.json` volledig herschrijft. - Markeringpersistentie is bronauthoritatief: markeringen worden geschreven vanuit de actieve bronconfigsnapshot (vóór oplossing), niet vanuit opgeloste runtime-geheime waarden. ### Details van providervelden - `models.mode`: gedrag van de providercatalogus (`merge` of `replace`). - `models.providers`: aangepaste providermap, geïndexeerd op provider-id. - Veilige bewerkingen: gebruik `openclaw config set models.providers. '' --strict-json --merge` of `openclaw config set models.providers..models '' --strict-json --merge` voor additieve updates. `config set` weigert destructieve vervangingen tenzij je `--replace` meegeeft. - `models.providers.*.api`: aanvraagadapter (`openai-completions`, `openai-responses`, `anthropic-messages`, `google-generative-ai`, enz.). Gebruik `openai-completions` voor zelfgehoste `/v1/chat/completions`-backends zoals MLX, vLLM, SGLang en de meeste OpenAI-compatibele lokale servers. Een aangepaste provider met `baseUrl` maar zonder `api` gebruikt standaard `openai-completions`; stel `openai-responses` alleen in wanneer de backend `/v1/responses` ondersteunt. - `models.providers.*.apiKey`: providerreferentie (bij voorkeur SecretRef/env-substitutie). - `models.providers.*.auth`: authenticatiestrategie (`api-key`, `token`, `oauth`, `aws-sdk`). - `models.providers.*.contextWindow`: standaard native contextvenster voor modellen onder deze provider wanneer de modelvermelding geen `contextWindow` instelt. - `models.providers.*.contextTokens`: standaard effectieve runtime-contextlimiet voor modellen onder deze provider wanneer de modelvermelding geen `contextTokens` instelt. - `models.providers.*.maxTokens`: standaardlimiet voor uitvoertokens voor modellen onder deze provider wanneer de modelvermelding geen `maxTokens` instelt. - `models.providers.*.timeoutSeconds`: optionele HTTP-aanvraagtime-out per provider-model in seconden, inclusief verbinding, headers, body en afhandeling van afbreken van de totale aanvraag. - `models.providers.*.injectNumCtxForOpenAICompat`: injecteer voor Ollama + `openai-completions` `options.num_ctx` in aanvragen (standaard: `true`). - `models.providers.*.authHeader`: forceer transport van referenties in de `Authorization`-header wanneer vereist. - `models.providers.*.baseUrl`: basis-URL van de upstream-API. - `models.providers.*.headers`: extra statische headers voor proxy-/tenantroutering. `models.providers.*.request`: transportoverschrijvingen voor HTTP-aanvragen aan modelproviders. - `request.headers`: extra headers (samengevoegd met providerstandaarden). Waarden accepteren SecretRef. - `request.auth`: overschrijving van authenticatiestrategie. Modi: `"provider-default"` (gebruik de ingebouwde authenticatie van de provider), `"authorization-bearer"` (met `token`), `"header"` (met `headerName`, `value`, optioneel `prefix`). - `request.proxy`: overschrijving van HTTP-proxy. Modi: `"env-proxy"` (gebruik de env-vars `HTTP_PROXY`/`HTTPS_PROXY`), `"explicit-proxy"` (met `url`). Beide modi accepteren een optioneel `tls`-subobject. - `request.tls`: TLS-overschrijving voor directe verbindingen. Velden: `ca`, `cert`, `key`, `passphrase` (allemaal accepteren SecretRef), `serverName`, `insecureSkipVerify`. - `request.allowPrivateNetwork`: wanneer `true`, HTTPS naar `baseUrl` toestaan wanneer DNS wordt opgelost naar private, CGNAT- of vergelijkbare bereiken, via de HTTP-fetchbeveiliging van de provider (operator-opt-in voor vertrouwde zelfgehoste OpenAI-compatibele endpoints). Stream-URL's voor modelproviders op loopback zoals `localhost`, `127.0.0.1` en `[::1]` worden automatisch toegestaan, tenzij dit expliciet op `false` is ingesteld; LAN-, tailnet- en private DNS-hosts vereisen nog steeds opt-in. WebSocket gebruikt dezelfde `request` voor headers/TLS, maar niet die fetch-SSRF-poort. Standaard `false`. - `models.providers.*.models`: expliciete modelcatalogusvermeldingen van de provider. - `models.providers.*.models.*.input`: modelinvoermodaliteiten. Gebruik `["text"]` voor modellen met alleen tekst en `["text", "image"]` voor native image-/vision-modellen. Afbeeldingsbijlagen worden alleen in agentbeurten geïnjecteerd wanneer het geselecteerde model als image-geschikt is gemarkeerd. - `models.providers.*.models.*.contextWindow`: metadata van het native modelcontextvenster. Dit overschrijft `contextWindow` op providerniveau voor dat model. - `models.providers.*.models.*.contextTokens`: optionele runtime-contextlimiet. Dit overschrijft `contextTokens` op providerniveau; gebruik dit wanneer je een kleiner effectief contextbudget wilt dan de native `contextWindow` van het model; `openclaw models list` toont beide waarden wanneer ze verschillen. - `models.providers.*.models.*.compat.supportsDeveloperRole`: optionele compatibiliteitshint. Voor `api: "openai-completions"` met een niet-lege niet-native `baseUrl` (host niet `api.openai.com`) forceert OpenClaw dit tijdens runtime naar `false`. Lege/weggelaten `baseUrl` behoudt standaard OpenAI-gedrag. - `models.providers.*.models.*.compat.requiresStringContent`: optionele compatibiliteitshint voor string-only OpenAI-compatibele chat-endpoints. Wanneer `true`, maakt OpenClaw pure tekst-`messages[].content`-arrays vlak tot gewone strings voordat de aanvraag wordt verzonden. - `models.providers.*.models.*.compat.strictMessageKeys`: optionele compatibiliteitshint voor strikte OpenAI-compatibele chat-endpoints. Wanneer `true`, beperkt OpenClaw uitgaande Chat Completions-berichtobjecten tot `role` en `content` voordat de aanvraag wordt verzonden. - `models.providers.*.models.*.compat.thinkingFormat`: optionele hint voor thinking-payload. Gebruik `"qwen"` voor `enable_thinking` op topniveau, of `"qwen-chat-template"` voor `chat_template_kwargs.enable_thinking` op Qwen-familie OpenAI-compatibele servers die chat-template-kwargs op aanvraagniveau ondersteunen, zoals vLLM. - `plugins.entries.amazon-bedrock.config.discovery`: root van Bedrock-instellingen voor automatische discovery. - `plugins.entries.amazon-bedrock.config.discovery.enabled`: impliciete discovery in-/uitschakelen. - `plugins.entries.amazon-bedrock.config.discovery.region`: AWS-regio voor discovery. - `plugins.entries.amazon-bedrock.config.discovery.providerFilter`: optioneel provider-id-filter voor gerichte discovery. - `plugins.entries.amazon-bedrock.config.discovery.refreshInterval`: pollinginterval voor discovery-vernieuwing. - `plugins.entries.amazon-bedrock.config.discovery.defaultContextWindow`: fallback-contextvenster voor ontdekte modellen. - `plugins.entries.amazon-bedrock.config.discovery.defaultMaxTokens`: fallbackmaximum voor uitvoertokens voor ontdekte modellen. Interactieve onboarding voor aangepaste providers leidt afbeeldingsinvoer af voor veelvoorkomende vision-model-ID's zoals GPT-4o, Claude, Gemini, Qwen-VL, LLaVA, Pixtral, InternVL, Mllama, MiniCPM-V en GLM-4V, en slaat de extra vraag over voor bekende families die alleen tekst ondersteunen. Onbekende model-ID's vragen nog steeds om afbeeldingsondersteuning. Niet-interactieve onboarding gebruikt dezelfde afleiding; geef `--custom-image-input` door om metadata voor afbeeldingsgeschikte modellen af te dwingen of `--custom-text-input` om metadata voor alleen tekst af te dwingen. ### Providervoorbeelden De meegeleverde `cerebras`-provider-Plugin kan dit configureren via `openclaw onboard --auth-choice cerebras-api-key`. Gebruik expliciete providerconfiguratie alleen wanneer je standaardwaarden overschrijft. ```json5 { env: { CEREBRAS_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "cerebras/zai-glm-4.7", fallbacks: ["cerebras/gpt-oss-120b"], }, models: { "cerebras/zai-glm-4.7": { alias: "GLM 4.7 (Cerebras)" }, "cerebras/gpt-oss-120b": { alias: "GPT OSS 120B (Cerebras)" }, }, }, }, models: { mode: "merge", providers: { cerebras: { baseUrl: "https://api.cerebras.ai/v1", apiKey: "${CEREBRAS_API_KEY}", api: "openai-completions", models: [ { id: "zai-glm-4.7", name: "GLM 4.7 (Cerebras)" }, { id: "gpt-oss-120b", name: "GPT OSS 120B (Cerebras)" }, ], }, }, }, } ``` Gebruik `cerebras/zai-glm-4.7` voor Cerebras; `zai/glm-4.7` voor Z.AI direct. ```json5 { env: { KIMI_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "kimi/kimi-for-coding" }, models: { "kimi/kimi-for-coding": { alias: "Kimi Code" } }, }, }, } ``` Anthropic-compatibele, ingebouwde provider. Snelkoppeling: `openclaw onboard --auth-choice kimi-code-api-key`. Zie [Lokale modellen](/nl/gateway/local-models). Kort gezegd: draai een groot lokaal model via de LM Studio Responses API op serieuze hardware; houd gehoste modellen samengevoegd als fallback. ```json5 { agents: { defaults: { model: { primary: "minimax/MiniMax-M2.7" }, models: { "minimax/MiniMax-M2.7": { alias: "Minimax" }, }, }, }, models: { mode: "merge", providers: { minimax: { baseUrl: "https://api.minimax.io/anthropic", apiKey: "${MINIMAX_API_KEY}", api: "anthropic-messages", models: [ { id: "MiniMax-M2.7", name: "MiniMax M2.7", reasoning: true, input: ["text"], cost: { input: 0.3, output: 1.2, cacheRead: 0.06, cacheWrite: 0.375 }, contextWindow: 204800, maxTokens: 131072, }, ], }, }, }, } ``` Stel `MINIMAX_API_KEY` in. Snelkoppelingen: `openclaw onboard --auth-choice minimax-global-api` of `openclaw onboard --auth-choice minimax-cn-api`. De modelcatalogus gebruikt standaard alleen M2.7. Op het Anthropic-compatibele streamingpad schakelt OpenClaw MiniMax-denken standaard uit, tenzij je zelf expliciet `thinking` instelt. `/fast on` of `params.fastMode: true` herschrijft `MiniMax-M2.7` naar `MiniMax-M2.7-highspeed`. ```json5 { env: { MOONSHOT_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "moonshot/kimi-k2.6" }, models: { "moonshot/kimi-k2.6": { alias: "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", reasoning: false, input: ["text", "image"], cost: { input: 0.95, output: 4, cacheRead: 0.16, cacheWrite: 0 }, contextWindow: 262144, maxTokens: 262144, }, ], }, }, }, } ``` Voor het China-eindpunt: `baseUrl: "https://api.moonshot.cn/v1"` of `openclaw onboard --auth-choice moonshot-api-key-cn`. Native Moonshot-eindpunten adverteren compatibiliteit met streaminggebruik op het gedeelde `openai-completions`-transport, en OpenClaw baseert dat op eindpuntmogelijkheden in plaats van alleen op de ingebouwde provider-ID. ```json5 { agents: { defaults: { model: { primary: "opencode/claude-opus-4-6" }, models: { "opencode/claude-opus-4-6": { alias: "Opus" } }, }, }, } ``` Stel `OPENCODE_API_KEY` (of `OPENCODE_ZEN_API_KEY`) in. Gebruik `opencode/...`-refs voor de Zen-catalogus of `opencode-go/...`-refs voor de Go-catalogus. Snelkoppeling: `openclaw onboard --auth-choice opencode-zen` of `openclaw onboard --auth-choice opencode-go`. ```json5 { env: { SYNTHETIC_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.5" }, models: { "synthetic/hf:MiniMaxAI/MiniMax-M2.5": { alias: "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", reasoning: true, input: ["text"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 192000, maxTokens: 65536, }, ], }, }, }, } ``` De basis-URL moet `/v1` weglaten (de Anthropic-client voegt die toe). Snelkoppeling: `openclaw onboard --auth-choice synthetic-api-key`. ```json5 { agents: { defaults: { model: { primary: "zai/glm-4.7" }, models: { "zai/glm-4.7": {} }, }, }, } ``` Stel `ZAI_API_KEY` in. `z.ai/*` en `z-ai/*` worden geaccepteerd als aliassen. Snelkoppeling: `openclaw onboard --auth-choice zai-api-key`. - Algemeen eindpunt: `https://api.z.ai/api/paas/v4` - Coding-eindpunt (standaard): `https://api.z.ai/api/coding/paas/v4` - Definieer voor het algemene eindpunt een aangepaste provider met de overschrijving voor de basis-URL. --- ## Gerelateerd - [Configuratie — agents](/nl/gateway/config-agents) - [Configuratie — kanalen](/nl/gateway/config-channels) - [Configuratiereferentie](/nl/gateway/configuration-reference) — andere sleutels op topniveau - [Tools en plugins](/nl/tools)