Providers
Anthropic
Anthropic bouwt de Claude-modelfamilie. OpenClaw ondersteunt twee auth-routes:
- API-sleutel — directe toegang tot de Anthropic API met gebruiksgebaseerde facturering (
anthropic/*-modellen) - Claude CLI — hergebruik een bestaande Claude Code-login op dezelfde host
Aan de slag
API-sleutel
Best voor: standaard API-toegang en gebruiksgebaseerde facturering.
Haal je API-sleutel op
Maak een API-sleutel aan in de Anthropic Console.
Voer onboarding uit
openclaw onboard# choose: Anthropic API keyOf geef de sleutel direct door:
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"Controleer of het model beschikbaar is
openclaw models list --provider anthropicConfig-voorbeeld
{ env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" }, agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },}Claude CLI
Best voor: het hergebruiken van een bestaande Claude CLI-login zonder aparte API-sleutel.
Zorg dat Claude CLI is geinstalleerd en aangemeld
Controleer met:
claude --versionVoer onboarding uit
openclaw onboard# choose: Claude CLIOpenClaw detecteert en hergebruikt de bestaande Claude CLI-referenties.
Controleer of het model beschikbaar is
openclaw models list --provider anthropicConfig-voorbeeld
Geef de voorkeur aan de canonieke Anthropic-modelreferentie plus een CLI-runtimeoverride:
{ agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" }, models: { "anthropic/claude-opus-4-8": { agentRuntime: { id: "claude-cli" }, }, }, }, },}Verouderde claude-cli/claude-opus-4-7-modelreferenties werken nog steeds voor
compatibiliteit, maar nieuwe config moet provider/modelselectie behouden als
anthropic/* en de uitvoeringsbackend in provider/model-runtimebeleid plaatsen.
Facturering en claude -p
OpenClaw gebruikt het niet-interactieve claude -p-pad van Claude Code voor Claude CLI-
uitvoeringen. Anthropic behandelt dat pad momenteel als Agent SDK/programmatisch gebruik:
- De supportupdate van Anthropic van 15 juni 2026 heeft het eerder aangekondigde aparte Agent SDK-tegoedplan gepauzeerd.
- Voor nu tellen Claude Agent SDK,
claude -pen appgebruik van derden binnen abonnementen nog steeds mee voor de gebruikslimieten van het aangemelde abonnement. - Het eerder aangekondigde maandelijkse Agent SDK-tegoed is niet beschikbaar terwijl Anthropic dat plan herziet.
- Console/API-sleutel-logins gebruiken pay-as-you-go API-facturering en ontvangen niet het Agent SDK-tegoed van het abonnement.
Zie Anthropic's Agent SDK-abonnementsartikel voor de pauzemelding, en de Claude Code-abonnementsartikelen voor Pro/Max en Team/Enterprise abonnementswerking.
Anthropic kan Claude Code-facturering en rate-limitgedrag wijzigen zonder een
OpenClaw-release. Controleer claude auth status, /status en
de gelinkte documentatie van Anthropic wanneer voorspelbaarheid van facturering belangrijk is.
Thinking-standaarden (Claude Fable 5, 4.8 en 4.6)
anthropic/claude-fable-5 gebruikt altijd adaptief denken en heeft standaard high
inspanning. Omdat Anthropic niet toestaat dat thinking voor dit model wordt uitgeschakeld,
gebruiken /think off en /think minimal low inspanning. OpenClaw laat ook aangepaste
temperatuurwaarden weg voor Fable 5-aanvragen.
Claude Opus 4.8 houdt thinking standaard uit in OpenClaw. Wanneer je adaptief denken expliciet inschakelt met /think high|xhigh|max, stuurt OpenClaw Anthropic's Opus 4.8-inspanningswaarden; Claude 4.6-modellen gebruiken standaard adaptive.
Overschrijf per bericht met /think:<level> of in modelparameters:
{ agents: { defaults: { models: { "anthropic/claude-opus-4-8": { params: { thinking: "high" }, }, }, }, },}Safety refusal-fallback (Claude Fable 5)
Waarom dit bestaat
Fable 5-classifiers retourneren stop_reason: "refusal" bij aanvragen in beperkte
domeinen, en ze geven ook vals-positieven bij werk dat aan goedaardig grenst (security-
tooling, life sciences, of zelfs het model vragen zijn ruwe
redenering te reproduceren). Zonder fallback sterft de beurt met een fout, ook al zou
een ander Claude-model die graag afhandelen — Anthropic's eigen weigeringsbericht
vertelt API-integrators om een fallbackmodel te configureren.
Hoe het werkt
- Voor elke directe API-sleutelaanvraag naar
anthropic/claude-fable-5stuurt OpenClaw Anthropic's server-side fallback-opt-in: deserver-side-fallback-2026-06-01beta-header plusfallbacks: [{"model": "claude-opus-4-8"}]. Claude Opus 4.8 is het enige fallbackdoel dat Anthropic toestaat voor Fable 5. - Alleen een weigering door een safety-classifier activeert de fallback. Rate limits, overbelasting en serverfouten gedragen zich precies zoals voorheen en lopen via OpenClaw's normale model-failover.
- De redding gebeurt binnen dezelfde aanroep. Een weigering voor enige uitvoer is onzichtbaar behalve door latency; het hele antwoord komt van Opus 4.8. Bij een weigering halverwege de stream blijft de gedeeltelijke tekst behouden als het voorvoegsel waarvan het fallback- model verdergaat, terwijl de redenering en toolaanroepen van het geweigerde model worden weggegooid volgens Anthropic's replayregels (ze mogen niet worden teruggekaatst of uitgevoerd).
- Als Claude Opus 4.8 ook weigert, toont de beurt de weigering als een fout, precies zoals voor deze functie.
De fallback gebeurt op Anthropic API-niveau, dus claude-opus-4-8 hoeft niet
in je geconfigureerde modellenlijst of fallbackketen te staan — een Fable-geschikte
API-sleutel kan altijd Opus leveren.
Observeerbaarheid en facturering
- Een door fallback afgehandelde beurt registreert een
provider_fallback-diagnostic op het assistentbericht metfromModelentoModel, en deresponseModelvan het bericht rapporteertclaude-opus-4-8. - Anthropic factureert per poging: een weigering voor uitvoer is gratis, en de redding wordt gefactureerd tegen Claude Opus 4.8-tarieven (momenteel de helft van Fable 5-tarieven). OpenClaw's kostenraming per beurt prijst door fallback afgehandelde beurten tegen Opus-tarieven om daarmee overeen te komen.
- Een weigering halverwege de stream factureert daarnaast het al gestreamde Fable-deel aan Anthropic's kant; dat deel wordt gerapporteerd in het API-gebruik per poging maar niet opgenomen in OpenClaw's raming per beurt.
Bereik
Van toepassing op anthropic/claude-fable-5 met API-sleutel-auth tegen
api.anthropic.com. OAuth (hergebruik van Claude CLI-abonnement), proxybasis-URL's,
Bedrock, Vertex en Foundry-aanvragen blijven ongewijzigd en tonen daar nog steeds
weigeringen als fouten.
Live geverifieerd: een goedaardige prompt die Fable 5 vraagt zijn ruwe chain of
thought te reproduceren wordt geweigerd met category: "reasoning_extraction" wanneer verzonden zonder
fallbacks, en dezelfde prompt via OpenClaw retourneert een normaal door Opus afgehandeld
antwoord met de provider_fallback-diagnostic eraan gekoppeld.
Zie Anthropic's gids voor weigeringen en fallback voor het onderliggende gedrag.
Promptcaching
OpenClaw ondersteunt Anthropic's promptcachingfunctie voor API-sleutel-auth.
| Waarde | Cacheduur | Beschrijving |
|---|---|---|
"short" (standaard) |
5 minuten | Automatisch toegepast voor API-sleutel-auth |
"long" |
1 uur | Uitgebreide cache |
"none" |
Geen caching | Promptcaching uitschakelen |
{ agents: { defaults: { models: { "anthropic/claude-opus-4-6": { params: { cacheRetention: "long" }, }, }, }, },}Cache-overschrijvingen per agent
Gebruik parameters op modelniveau als je basislijn en overschrijf vervolgens specifieke agents via agents.list[].params:
{ agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" }, models: { "anthropic/claude-opus-4-6": { params: { cacheRetention: "long" }, }, }, }, list: [ { id: "research", default: true }, { id: "alerts", params: { cacheRetention: "none" } }, ], },}Volgorde voor config-samenvoeging:
agents.defaults.models["provider/model"].paramsagents.list[].params(overeenkomendeid, overschrijft per sleutel)
Hiermee kan één agent een langdurige cache behouden terwijl een andere agent op hetzelfde model caching uitschakelt voor piekerig verkeer met weinig hergebruik.
Bedrock Claude-opmerkingen
- Anthropic Claude-modellen op Bedrock (
amazon-bedrock/*anthropic.claude*) accepterencacheRetention-doorgifte wanneer geconfigureerd. - Niet-Anthropic Bedrock-modellen worden tijdens runtime geforceerd naar
cacheRetention: "none". - Slimme standaardwaarden voor API-sleutels vullen ook
cacheRetention: "short"in voor Claude-on-Bedrock-refs wanneer er geen expliciete waarde is ingesteld.
Geavanceerde configuratie
Snelle modus
De gedeelde /fast-schakelaar van OpenClaw ondersteunt direct Anthropic-verkeer (API-sleutel en OAuth naar api.anthropic.com).
| Opdracht | Wordt gekoppeld aan |
|---|---|
/fast on |
service_tier: "auto" |
/fast off |
service_tier: "standard_only" |
{ agents: { defaults: { models: { "anthropic/claude-sonnet-4-6": { params: { fastMode: true }, }, }, }, },}Media-inzicht (afbeelding en PDF)
De gebundelde Anthropic-Plugin registreert inzicht in afbeeldingen en PDF's. OpenClaw leidt mediacapaciteiten automatisch af uit de geconfigureerde Anthropic-authenticatie — er is geen aanvullende configuratie nodig.
| Eigenschap | Waarde |
|---|---|
| Standaardmodel | claude-opus-4-8 |
| Ondersteunde invoer | Afbeeldingen, PDF-documenten |
Wanneer een afbeelding of PDF aan een gesprek wordt toegevoegd, routeert OpenClaw deze automatisch via de Anthropic-provider voor media-inzicht.
1M-contextvenster
Anthropic's 1M-contextvenster is beschikbaar op GA-geschikte Claude 4.x-modellen zoals Opus 4.8, Opus 4.7, Opus 4.6 en Sonnet 4.6. OpenClaw stelt die modellen automatisch in op 1M:
{ agents: { defaults: { models: { "anthropic/claude-opus-4-6": {}, }, }, },}Oudere configuraties kunnen params.context1m: true behouden, maar OpenClaw verzendt niet langer
de uitgefaseerde context-1m-2025-08-07-bètaheader. Oudere anthropicBeta-configuratie-items
met die waarde worden genegeerd tijdens het bepalen van aanvraagheaders en
niet-ondersteunde oudere Claude-modellen blijven op hun normale contextvenster.
params.context1m: true geldt ook voor de Claude CLI-backend
(claude-cli/*) voor in aanmerking komende GA-geschikte Opus- en Sonnet-modellen, waarbij
het runtime-contextvenster voor die CLI-sessies behouden blijft zodat het overeenkomt met het directe API-
gedrag.
Claude Opus 4.8 1M-context
anthropic/claude-opus-4-8 en de claude-cli-variant ervan hebben standaard een 1M-contextvenster — geen params.context1m: true nodig.
Probleemoplossing
401-fouten / token plotseling ongeldig
Anthropic-tokenauthenticatie verloopt en kan worden ingetrokken. Gebruik voor nieuwe setups in plaats daarvan een Anthropic API-sleutel.
Geen API-sleutel gevonden voor provider "anthropic"
Anthropic-authenticatie is per agent — nieuwe agents erven de sleutels van de hoofdagent niet. Voer onboarding opnieuw uit voor die agent (of configureer een API-sleutel op de gatewayhost) en verifieer daarna met openclaw models status.
Geen referenties gevonden voor profiel "anthropic:default"
Voer openclaw models status uit om te zien welk authenticatieprofiel actief is. Voer onboarding opnieuw uit, of configureer een API-sleutel voor dat profielpad.
Geen beschikbaar authenticatieprofiel (allemaal in cooldown)
Controleer openclaw models status --json op auth.unusableProfiles. Anthropic-rate-limit-cooldowns kunnen modelspecifiek zijn, dus een verwant Anthropic-model kan nog steeds bruikbaar zijn. Voeg een ander Anthropic-profiel toe of wacht tot de cooldown voorbij is.