Naar hoofdinhoud gaan
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
De Claude CLI-backend van OpenClaw voert de geinstalleerde Claude Code CLI uit in niet-interactieve printmodus. De huidige Claude Code-documentatie van Anthropic beschrijft claude -p als Agent SDK/programmatisch gebruik. De supportupdate van Anthropic van 15 juni 2026 heeft de aangekondigde wijziging in Agent SDK-facturering gepauzeerd. Voor nu zegt Anthropic dat gebruik van Claude Agent SDK, claude -p en apps van derden nog steeds meetelt voor de gebruikslimieten van een abonnement. Het eerder aangekondigde maandelijkse Agent SDK-tegoed is niet beschikbaar terwijl Anthropic dat plan herziet.Interactieve Claude Code telt nog steeds mee voor de limieten van het aangemelde Claude-abonnement. API- sleutel-auth blijft directe API-facturering op basis van pay-as-you-go. Gebruik voor langlopende gatewayhosts, gedeelde automatisering en voorspelbare productiekosten een Anthropic API-sleutel.Controleer de huidige supportartikelen van Anthropic voordat je vertrouwt op factureringsgedrag via abonnementen:

​
Aan de slag

Best voor: standaard API-toegang en gebruiksgebaseerde facturering.
1

Haal je API-sleutel op

Maak een API-sleutel aan in de Anthropic Console.
2

Voer onboarding uit

openclaw onboard
# choose: Anthropic API key
Of geef de sleutel direct door:
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
3

Controleer of het model beschikbaar is

openclaw models list --provider anthropic

​
Config-voorbeeld

{
  env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },
}

​
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" },
        },
      },
    },
  },
}
Gerelateerde Anthropic-documentatie:

​
Safety refusal-fallback (Claude Fable 5)

Claude Fable 5 gebruiken betekent ook Claude Opus 4.8 gebruiken. Fable 5 wordt geleverd met safety-classifiers die een aanvraag kunnen weigeren, en Anthropic’s gesanctioneerde herstel is om claude-opus-4-8 die beurt te laten afhandelen. OpenClaw schakelt dit automatisch in voor directe API-sleutelaanvragen, waardoor sommige Fable-beurten worden beantwoord en gefactureerd als Claude Opus 4.8. Als je beleid of budget door Opus afgehandelde beurten niet kan accepteren, selecteer dan niet anthropic/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

  1. Voor elke directe API-sleutelaanvraag naar anthropic/claude-fable-5 stuurt OpenClaw Anthropic’s server-side fallback-opt-in: de server-side-fallback-2026-06-01 beta-header plus fallbacks: [{"model": "claude-opus-4-8"}]. Claude Opus 4.8 is het enige fallbackdoel dat Anthropic toestaat voor Fable 5.
  2. 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.
  3. 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).
  4. 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 met fromModel en toModel, en de responseModel van het bericht rapporteert claude-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.
WaardeCacheduurBeschrijving
"short" (standaard)5 minutenAutomatisch toegepast voor API-sleutel-auth
"long"1 uurUitgebreide cache
"none"Geen cachingPromptcaching uitschakelen
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}
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:
  1. agents.defaults.models["provider/model"].params
  2. agents.list[].params (overeenkomende id, 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.
  • Anthropic Claude-modellen op Bedrock (amazon-bedrock/*anthropic.claude*) accepteren cacheRetention-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

De gedeelde /fast-schakelaar van OpenClaw ondersteunt direct Anthropic-verkeer (API-sleutel en OAuth naar api.anthropic.com).
OpdrachtWordt gekoppeld aan
/fast onservice_tier: "auto"
/fast offservice_tier: "standard_only"
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}
  • Alleen geïnjecteerd voor directe api.anthropic.com-aanvragen. Proxyroutes laten service_tier ongemoeid.
  • Expliciete serviceTier- of service_tier-params overschrijven /fast wanneer beide zijn ingesteld.
  • Op accounts zonder Priority Tier-capaciteit kan service_tier: "auto" uitkomen op standard.
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.
EigenschapWaarde
Standaardmodelclaude-opus-4-8
Ondersteunde invoerAfbeeldingen, PDF-documenten
Wanneer een afbeelding of PDF aan een gesprek wordt toegevoegd, routeert OpenClaw deze automatisch via de Anthropic-provider voor media-inzicht.
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.
Vereist toegang tot lange context op je Anthropic-referentie. OAuth-/abonnementstokenauthenticatie behoudt de vereiste Anthropic-bètaheaders, maar OpenClaw verwijdert de uitgefaseerde 1M-bètaheader als die nog in oudere configuratie staat.
anthropic/claude-opus-4-8 en de claude-cli-variant ervan hebben standaard een 1M-contextvenster — geen params.context1m: true nodig.

​
Probleemoplossing

Anthropic-tokenauthenticatie verloopt en kan worden ingetrokken. Gebruik voor nieuwe setups in plaats daarvan een Anthropic API-sleutel.
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.
Voer openclaw models status uit om te zien welk authenticatieprofiel actief is. Voer onboarding opnieuw uit, of configureer een API-sleutel voor dat profielpad.
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.
Meer hulp: Probleemoplossing en FAQ.

​
Gerelateerd

Modelselectie

Providers, modelrefs en failovergedrag kiezen.

CLI-backends

Instelling van de Claude CLI-backend en runtimedetails.

Promptcaching

Hoe promptcaching werkt tussen providers.

OAuth en auth

Auth-details en regels voor hergebruik van referenties.