Naar hoofdinhoud gaan

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.

tools.*-configuratiesleutels en aangepaste provider- / basis-URL-configuratie. Zie voor agents, kanalen en andere configuratiesleutels op topniveau de Configuratiereferentie.

​
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).
ProfielOmvat
minimalalleen session_status
codinggroup:fs, group:runtime, group:web, group:sessions, group:memory, cron, image, image_generate, video_generate
messaginggroup:messaging, sessions_list, sessions_history, sessions_send, session_status
fullGeen beperking (hetzelfde als niet ingesteld)

​
Hulpmiddelgroepen

GroepHulpmiddelen
group:runtimeexec, process, code_execution (bash wordt geaccepteerd als alias voor exec)
group:fsread, write, edit, apply_patch
group:sessionssessions_list, sessions_history, sessions_send, sessions_spawn, sessions_yield, subagents, session_status
group:memorymemory_search, memory_get
group:webweb_search, x_search, web_fetch
group:uibrowser, canvas
group:automationheartbeat_respond, cron, gateway
group:messagingmessage
group:nodesnodes
group:agentsagents_list, update_plan
group:mediaimage, image_generate, music_generate, video_generate, tts
group:openclawAlle 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. 
{
  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: 
{
  tools: { deny: ["write", "edit", "apply_patch"] },
}

​
tools.byProvider

Beperk hulpmiddelen verder voor specifieke providers of modellen. Volgorde: basisprofiel → providerprofiel → allow/deny. 
{
  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. 
{
  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:<channelId>:<senderId>, id:<senderId>, e164:<phone>, username:<handle>, name:<displayName>, 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: 
{
  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

{
  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. 
{
  tools: {
    loopDetection: {
      enabled: true,
      historySize: 30,
      warningThreshold: 10,
      criticalThreshold: 20,
      globalCircuitBreakerThreshold: 30,
      detectors: {
        genericRepeat: true,
        knownPollNoProgress: true,
        pingPong: true,
      },
    },
  },
}
​
historySize
number
Maximaal bewaarde tool-call-geschiedenis voor loopanalyse.
​
warningThreshold
number
Drempel voor herhalende patronen zonder voortgang voor waarschuwingen.
​
criticalThreshold
number
Hogere herhalingsdrempel voor het blokkeren van kritieke loops.
​
globalCircuitBreakerThreshold
number
Harde stopdrempel voor elke run zonder voortgang.
​
detectors.genericRepeat
boolean
Waarschuw bij herhaalde aanroepen met dezelfde tool/dezelfde argumenten.
​
detectors.knownPollNoProgress
boolean
Waarschuw/blokkeer bij bekende poll-tools (process.poll, command_status, enz.).
​
detectors.pingPong
boolean
Waarschuw/blokkeer bij afwisselende paarpatronen zonder voortgang.
Als warningThreshold >= criticalThreshold of criticalThreshold >= globalCircuitBreakerThreshold, mislukt de validatie.

​
tools.web

{
  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): 
{
  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

{
  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). 
{
  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. 
{
  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/<uuid>/ 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. 
{
  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

{
  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/<agentId>/agent/models.json. 
{
  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.<id> '<json>' --strict-json --merge of openclaw config set models.providers.<id>.models '<json-array>' --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.
{
  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.
{
  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. Kort gezegd: draai een groot lokaal model via de LM Studio Responses API op serieuze hardware; houd gehoste modellen samengevoegd als fallback.
{
  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.
{
  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.
{
  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.
{
  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.
{
  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