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

    bash
    openclaw onboard# choose: Anthropic API key

    Of geef de sleutel direct door:

    bash
    openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
  • Controleer of het model beschikbaar is

    bash
    openclaw models list --provider anthropic
  • Config-voorbeeld

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

    bash
    claude --version
  • Voer onboarding uit

    bash
    openclaw onboard# choose: Claude CLI

    OpenClaw detecteert en hergebruikt de bestaande Claude CLI-referenties.

  • Controleer of het model beschikbaar is

    bash
    openclaw models list --provider anthropic
  • Config-voorbeeld

    Geef de voorkeur aan de canonieke Anthropic-modelreferentie plus een CLI-runtimeoverride:

    json5
    {  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 -p en 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:

    json5
    {  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

    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.

    Waarde Cacheduur Beschrijving
    "short" (standaard) 5 minuten Automatisch toegepast voor API-sleutel-auth
    "long" 1 uur Uitgebreide cache
    "none" Geen caching Promptcaching uitschakelen
    json5
    {  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:

    json5
    {  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.

    Bedrock Claude-opmerkingen
    • 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

    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"
    json5
    {  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:

    json5
    {  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.

    Gerelateerd

    Was this useful?
    On this page

    On this page