Providers

Anthropic

Anthropic bouwt de Claude-modelfamilie. OpenClaw ondersteunt twee authenticatieroutes:

  • API-sleutel - rechtstreekse toegang tot de Anthropic-API met facturering op basis van gebruik (anthropic/*-modellen)
  • Claude CLI - hergebruik een bestaande Claude Code-aanmelding op dezelfde host

Gebruiks- en kostentracering

OpenClaw detecteert de beschikbare Anthropic-referentie en selecteert het bijbehorende gebruiksoverzicht:

  • Referenties voor een Claude-abonnement of -configuratie tonen quotumperiodes en een optioneel budget voor extra gebruik.
  • ANTHROPIC_ADMIN_KEY of ANTHROPIC_ADMIN_API_KEY toont 30 dagen aan door de provider gerapporteerde organisatiekosten en gebruik van de Messages API in Usage van de Control UI, inclusief dagelijkse uitgaven, totalen voor tokens/cache, populairste modellen en kostencategorieën.
  • Een sk-ant-admin...-referentie die in het Anthropic-providerprofiel is opgeslagen, wordt automatisch als Admin API-sleutel gedetecteerd.

De kostengeschiedenis van de Admin API komt uit Anthropics Usage and Cost API. Dit betreft de werkelijke facturering door de provider, los van de door OpenClaw op basis van sessies geschatte kosten.

Aan de slag

API-sleutel

Het meest geschikt voor: standaard API-toegang en facturering op basis van gebruik.

  • Verkrijg je API-sleutel

    Maak een API-sleutel aan in de Anthropic Console.

  • Voer de onboarding uit

    bash
    openclaw onboard# kies: Anthropic API key

    Of geef de sleutel rechtstreeks door:

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

    bash
    openclaw models list --provider anthropic
  • Configuratievoorbeeld

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

    Claude CLI

    Het meest geschikt voor: een bestaande Claude CLI-aanmelding hergebruiken zonder afzonderlijke API-sleutel.

  • Zorg dat Claude CLI is geïnstalleerd en aangemeld

    Controleer dit met:

    bash
    claude --version
  • Voer de onboarding uit

    bash
    openclaw onboard# kies: Claude CLI

    OpenClaw detecteert en hergebruikt de bestaande Claude CLI-referenties.

  • Controleer of het model beschikbaar is

    bash
    openclaw models list --provider anthropic
  • Een configuratietoken verkrijgen

    Voer claude setup-token uit op een willekeurige machine waarop Claude Code is geïnstalleerd. Hiermee wordt een langlevend token afgedrukt dat begint met sk-ant-oat01-.

    Plak het token tijdens de onboarding in de macOS-app door Anthropic setup-token te kiezen onder Connect with an API key or token, of gebruik:

    bash
    openclaw models auth login --provider anthropic --method setup-token

    Configuratievoorbeeld

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

    json5
    {  agents: {    defaults: {      model: { primary: "anthropic/claude-opus-5" },      models: {        "anthropic/claude-opus-5": {          agentRuntime: { id: "claude-cli" },        },      },    },  },}

    Verouderde claude-cli/claude-opus-4-7-modelreferenties blijven werken voor compatibiliteit, maar nieuwe configuraties moeten de provider-/modelselectie als anthropic/* behouden en de uitvoeringsbackend in het runtimebeleid voor de provider/het model 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 gebruik via de Agent SDK/programmatisch gebruik:

    • Anthropics ondersteuningsupdate van 15 juni 2026 heeft het eerder aangekondigde afzonderlijke tegoedplan voor de Agent SDK opgeschort.
    • Gebruik van de Claude Agent SDK binnen een abonnement, claude -p en apps van derden valt nog steeds onder de gebruikslimieten van het aangemelde abonnement.
    • Het eerder aangekondigde maandelijkse tegoed voor de Agent SDK is niet beschikbaar zolang Anthropic dat plan herziet.
    • Aanmeldingen via de Console/API-sleutel gebruiken API-facturering op basis van gebruik en ontvangen het Agent SDK-tegoed van het abonnement niet.

    Zie Anthropics artikel over het Agent SDK-abonnement voor de kennisgeving over de opschorting, en de artikelen over Claude Code-abonnementen voor het abonnementsgedrag van Pro/Max en Team/Enterprise.

    Anthropic kan de facturering en het gedrag van snelheidslimieten van Claude Code wijzigen zonder een OpenClaw-release. Controleer claude auth status, /status en de gekoppelde documentatie van Anthropic wanneer voorspelbare facturering belangrijk is.

    Claude-sessies op verschillende computers

    De gebundelde Anthropic-plugin voegt een groep Claude Code toe aan de normale sessiezijbalk. Rijen worden geopend in het normale chatvenster. De plugin vindt niet-gearchiveerde Claude Code-sessies op de Gateway en op verbonden nodehosts:

    • Claude CLI-sessies zijn afkomstig uit geldige projectindexrecords. Voor niet-geïndexeerde transcripten herkent een begrensde terugval op metadata gelijktijdige interactieve sessies zonder zijketen (cli) en headless CLI-sessies van de Agent SDK (sdk-cli) onder ~/.claude/projects/.
    • Claude Desktop-sessies gebruiken de Desktop-titel, activiteitstijd en archiefstatus wanneer de metadata naar dezelfde Claude Code-sessie-ID verwijst.
    • Een sessie die alleen via de CLI bestaat, heeft geen archiefvlag en blijft daarom zichtbaar zolang het transcript aanwezig is.

    Voor detectie is geen aanvullende OpenClaw-configuratie vereist. De Anthropic-plugin is gebundeld en standaard ingeschakeld; een native macOS-node maakt de alleen-lezen opdrachten voor Claude-sessies bekend wanneer de lokale map ~/.claude/projects/ bestaat. Keur de upgrade van de nodekoppeling goed wanneer die opdrachten voor het eerst verschijnen.

    De zijbalk groepeert rijen op Gateway- of gekoppelde-nodehost en toont de nieuwste begrensde pagina van elke host zodra die computer antwoordt. De gegevens worden opnieuw afgestemd na wijzigingen in de hostconnectiviteit, wanneer de pagina opnieuw focus krijgt en maximaal elke 30 seconden zolang deze zichtbaar is, zodat Claude-sessies die buiten OpenClaw zijn gemaakt zonder herladen verschijnen. Bij een gewijzigde catalogus volgt sneller een extra controle. Gebruik Meer sessies laden onder een catalogusgroep om voor elke host met meer geschiedenis de volgende pagina toe te voegen; toegevoegde rijen blijven zichtbaar en worden bij vernieuwingen opnieuw tot dezelfde diepte opgehaald. Catalogusclients gebruiken sessions.catalog.list; bij het openen van een rij wordt sessions.catalog.read gebruikt.

    Bij terminalovername wordt claude opgezocht via de PATH van de aanmeldingsshell van de gebruiker van de eigenaarhost, vóór de PATH van de service/daemon. Hierdoor blijven vanuit de app gestarte sessies afgestemd op de Claude CLI die de beheerder in een normale terminal gebruikt.

    Wanneer je een rij selecteert, wordt eerst de nieuwste transcriptpagina gelezen. Oudere transcriptitems laden volgt een ondoorzichtige bytecursor en leest nog een begrensd gedeelte uit het JSONL-bestand in plaats van de volledige geschiedenis te laden. Normale inhoud van gebruikers, assistenten, redeneringen, toolaanroepen en toolresultaten blijft behouden. Een afzonderlijk item dat groter is dan de veiligheidslimiet van de node/Gateway wordt duidelijk als afgekapt gemarkeerd.

    Wanneer je in de normale editor van een Gateway-lokale claude-cli-rij typt, wordt sessions.catalog.continue aangeroepen. OpenClaw zoekt het lokale catalogusrecord opnieuw op, maakt een modelgebonden native sessie of hergebruikt deze, importeert maximaal 200 zichtbare items of 512 KiB en initialiseert de Claude CLI-koppeling. De eerste beurt wordt hervat met --fork-session; Claude wijst de fork een nieuwe sessie-ID toe, zodat latere beurten de fork gebruiken en de bronsessie ongewijzigd blijft.

    Een headless nodehost kan zijn Claude CLI-rijen ook voortzetbaar maken door de onderstaande node-lokale instelling in te schakelen en de nodehost opnieuw te starten:

    json5
    {  nodeHost: {    agentRuns: {      claude: { enabled: true },    },  },}

    De node maakt agent.cli.claude.run.v1 alleen bekend wanneer de instelling is ingeschakeld en het lokale uitvoerbare bestand claude kan worden gevonden. OpenClaw zoekt het catalogusrecord opnieuw op die node op, importeert dezelfde begrensde geschiedenis en koppelt de overgenomen sessie aan de node en de door de catalogus gerapporteerde werkmap. Elke beurt voert het echte claude -p-proces van de node uit met de Claude-bestanden en aanmelding van die node. Het goedkeuringsbeleid voor uitvoeropdrachten van de node blijft van toepassing; de Gateway kan de opt-in niet afdwingen.

    Nodevoortzetting v1 is uitsluitend eenmalig. Gateway-loopback-MCP-configuratie en argumenten voor de Gateway Skills-plugin worden weggelaten, er wordt niet opnieuw geïnitialiseerd vanuit een Gateway-transcript en bijlagen en afbeeldingen worden geweigerd. Claude Desktop-rijen blijven alleen-lezen. Native macOS-appnodes blijven ook alleen-lezen totdat de app de uitvoeropdracht bekendmaakt.

    Zie Nodes: Claude-sessies en transcripties voor de Node-opdracht en beveiligingsgrens.

    Standaardinstellingen voor denken (Claude Opus 5, Sonnet 5, Mythos 5, Fable 5, 4.8 en 4.6)

    anthropic/claude-opus-5 gebruikt standaard adaptief denken met inspanningsniveau high. Gebruik /think off om denken uit te schakelen, of /think xhigh|max voor de hogere systeemeigen inspanningsniveaus van het model. OpenClaw laat handmatige denkbudgetten, aangepaste samplingparameters, vooraf ingevulde assistenttekst en Priority Tier voor Opus 5 weg, omdat Anthropic deze aanvraagfuncties niet ondersteunt voor dit model. De catalogus vermeldt het contextvenster van 1.000.000 tokens, de uitvoerlimiet van 128.000 tokens, afbeeldingsinvoer en de $5/$25-prijzen voor invoer/uitvoer.

    anthropic/claude-sonnet-5 gebruikt dezelfde standaardinstellingen voor adaptief denken en aanvraagbeperkingen. De catalogus gebruikt tot en met 31 augustus 2026 de introductieprijzen van Anthropic van $2/$10 voor invoer/uitvoer; de standaardprijzen van $3/$15 gaan in op 1 september 2026.

    anthropic/claude-fable-5 gebruikt altijd adaptief denken en hanteert standaard inspanningsniveau high. Anthropic staat niet toe dat denken voor dit model wordt uitgeschakeld, dus /think off en /think minimal worden in plaats daarvan toegewezen aan inspanningsniveau low. OpenClaw laat ook aangepaste temperatuurwaarden weg voor Fable 5-aanvragen, omdat Anthropic een temperatuur-override afwijst voor elke aanvraag waarbij denken is ingeschakeld.

    anthropic/claude-mythos-5 is een model met beperkte toegang en hetzelfde contract voor altijd ingeschakeld adaptief denken. OpenClaw gebruikt standaard high, wijst /think off en /think minimal toe aan low en laat door de aanroeper gekozen samplingparameters weg. De catalogus vermeldt het contextvenster van 1.000.000 tokens, de uitvoerlimiet van 128.000 tokens, afbeeldingsinvoer en de $10/$50-prijzen voor invoer/uitvoer.

    Claude Opus 4.8 houdt denken standaard uitgeschakeld in OpenClaw. Wanneer je adaptief denken expliciet inschakelt met /think high|xhigh|max, verzendt OpenClaw de inspanningswaarden van Anthropic voor Opus 4.8; Claude 4.6-modellen (Opus 4.6 en Sonnet 4.6) gebruiken standaard adaptive.

    Overschrijf dit per bericht met /think:<level> of in de modelparameters:

    json5
    {  agents: {    defaults: {      models: {        "anthropic/claude-opus-5": {          params: { thinking: "high" },        },      },    },  },}

    Terugvaloptie bij veiligheidsweigering (Claude Fable 5)

    Waarom dit bestaat

    Fable 5-classificatoren retourneren stop_reason: "refusal" bij aanvragen in beperkte domeinen en leveren ook fout-positieve resultaten op bij aangrenzend, onschadelijk werk (beveiligingstools, levenswetenschappen of zelfs de vraag aan het model om zijn onbewerkte redenering te reproduceren). Zonder terugvaloptie eindigt de beurt met een fout, hoewel een ander Claude-model de aanvraag zonder problemen zou afhandelen. Het weigeringsbericht van Anthropic zelf vertelt API-integrators een terugvalmodel te configureren.

    Hoe het werkt

    1. Voor elke rechtstreekse aanvraag met een API-sleutel aan anthropic/claude-fable-5 verzendt OpenClaw de serverzijdige aanmelding voor terugval van Anthropic: de bètaheader server-side-fallback-2026-06-01 plus fallbacks: [{"model": "claude-opus-4-8"}]. Claude Opus 4.8 is het enige terugvaldoel dat Anthropic toestaat voor Fable 5.
    2. Alleen een weigering door een veiligheidsclassificator activeert de terugvaloptie. Snelheidslimieten, overbelasting en serverfouten gedragen zich precies zoals voorheen en verlopen via de normale modelovername van OpenClaw.
    3. De reddingsactie vindt binnen dezelfde aanroep plaats. Een weigering vóór enige uitvoer is afgezien van de latentie onzichtbaar; het volledige antwoord is afkomstig van Opus 4.8. Bij een weigering tijdens het streamen blijft de gedeeltelijke tekst behouden als voorvoegsel vanwaar het terugvalmodel verdergaat, terwijl de redenering en toolaanroepen van het weigerende model volgens de replayregels van Anthropic worden verwijderd (ze mogen niet worden teruggestuurd of uitgevoerd).
    4. Als Claude Opus 4.8 eveneens weigert, wordt de weigering voor de beurt als fout weergegeven, precies zoals vóór deze functie.

    De terugval vindt plaats op het niveau van de Anthropic-API, dus claude-opus-4-8 hoeft niet in je geconfigureerde modellenlijst of terugvalketen te staan: een API-sleutel die Fable ondersteunt, kan altijd Opus afhandelen.

    Observeerbaarheid en facturering

    • Een door de terugvaloptie afgehandelde beurt registreert een diagnose provider_fallback in het assistentbericht waarin fromModel en toModel worden genoemd, en de responseModel van het bericht rapporteert claude-opus-4-8.
    • Anthropic factureert per poging: een weigering vóór uitvoer is gratis en de reddingsactie wordt gefactureerd tegen Claude Opus 4.8-tarieven (momenteel de helft van de Fable 5-tarieven). De kostenraming per beurt van OpenClaw berekent door terugval afgehandelde beurten tegen Opus-tarieven om hiermee overeen te komen.
    • Bij een weigering tijdens het streamen factureert Anthropic bovendien het reeds gestreamde gedeeltelijke Fable-resultaat; dat gedeelte wordt gerapporteerd in het verbruik per poging van de API, maar niet opgenomen in de raming per beurt van OpenClaw.

    Toepassingsgebied

    Van toepassing op anthropic/claude-fable-5 met authenticatie via een API-sleutel bij api.anthropic.com. OAuth (hergebruik van een Claude CLI-abonnement), proxybasis-URL's, Bedrock-, Vertex- en Foundry-aanvragen blijven ongewijzigd en geven weigeringen daar nog steeds als fouten weer.

    Live geverifieerd: een onschuldige prompt waarin Fable 5 wordt gevraagd zijn onbewerkte redeneerketen te reproduceren, wordt zonder terugvalopties geweigerd met category: "reasoning_extraction", terwijl dezelfde prompt via OpenClaw een normaal, door Opus afgehandeld antwoord retourneert met de diagnose provider_fallback eraan gekoppeld.

    Zie de handleiding voor weigeringen en terugvalopties van Anthropic voor het onderliggende gedrag.

    Promptcaching

    OpenClaw ondersteunt de promptcachingfunctie van Anthropic voor authenticatie via een API-sleutel.

    Waarde Cacheduur Beschrijving
    "short" (standaard) 5 minuten Automatisch toegepast bij authenticatie via een API-sleutel
    "long" 1 uur Uitgebreide cache
    "none" Geen caching Promptcaching uitschakelen
    json5
    {  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-6": {          params: { cacheRetention: "long" },        },      },    },  },}
    Cache-overrides per agent

    Gebruik parameters op modelniveau als basis en overschrijf vervolgens specifieke agents via agents.entries.*.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 het samenvoegen van configuratie:

    1. agents.defaults.models["provider/model"].params
    2. agents.entries.*.params (overeenkomend met id, overschrijft per sleutel)

    Hierdoor kan één agent een langlevende cache behouden, terwijl een andere agent met hetzelfde model caching uitschakelt voor piekverkeer of verkeer met weinig hergebruik.

    Opmerkingen over Bedrock Claude
    • Anthropic Claude-modellen op Bedrock (amazon-bedrock/*anthropic.claude*) accepteren doorvoer van cacheRetention wanneer dit is geconfigureerd.
    • Niet-Anthropic-modellen op Bedrock worden tijdens runtime gedwongen tot cacheRetention: "none".
    • Slimme standaardinstellingen voor API-sleutels vullen ook cacheRetention: "short" in voor Claude-on-Bedrock-verwijzingen wanneer geen expliciete waarde is ingesteld.

    Geavanceerde configuratie

    Snelle modus

    De gedeelde /fast-schakelaar van OpenClaw stelt het veld service_tier van Anthropic in voor rechtstreeks verkeer met een API-sleutel naar api.anthropic.com.

    Opdracht Wordt toegewezen aan
    /fast on service_tier: "auto"
    /fast off service_tier: "standard_only"
    json5
    {  agents: {    defaults: {      models: {        "anthropic/claude-sonnet-4-6": {          params: { fastMode: true },        },      },    },  },}
    Mediabegrip (afbeeldingen en PDF)

    De gebundelde Anthropic-Plugin registreert begrip van afbeeldingen en PDF's. OpenClaw bepaalt mediacapaciteiten automatisch op basis van de geconfigureerde Anthropic-authenticatie; aanvullende configuratie is niet nodig.

    Eigenschap Waarde
    Standaardmodel claude-opus-5
    Ondersteunde invoer Afbeeldingen, PDF-documenten

    Wanneer een afbeelding of PDF aan een gesprek wordt toegevoegd, leidt OpenClaw deze automatisch via de Anthropic-provider voor mediabegrip.

    Contextvenster van 1M

    Claude Opus 5, Sonnet 5, Mythos 5 en Fable 5 hebben een exact invoervenster van 1.000.000 tokens en ondersteunen maximaal 128.000 uitvoertokens. Het contextvenster van 1M van Anthropic is ook algemeen beschikbaar voor Claude 4.x-modellen met adaptief denken: Opus 4.8, Opus 4.7, Opus 4.6 en Sonnet 4.6. OpenClaw stelt de grootte voor deze modellen automatisch in; params.context1m is niet nodig:

    json5
    {  agents: {    defaults: {      models: {        "anthropic/claude-opus-5": {},        "anthropic/claude-sonnet-5": {},        "anthropic/claude-mythos-5": {},        "anthropic/claude-opus-4-6": {},      },    },  },}

    Oudere configuraties kunnen params.context1m: true behouden; dit is een onschadelijke no-op voor deze modellen en OpenClaw verzendt de uitgefaseerde bètaheader context-1m-2025-08-07 niet meer, ongeacht de configuratie. Oudere anthropicBeta-configuratie-items met die waarde worden verwijderd tijdens het bepalen van aanvraagheaders, en niet-ondersteunde oudere Claude-modellen behouden hun normale contextvenster.

    params.context1m: true gedraagt zich op dezelfde manier voor de Claude CLI-backend (claude-cli/*): in aanmerking komende Opus- en Sonnet-modellen met algemene beschikbaarheid krijgen het 1M-venster al automatisch, dus ook daar is de parameter optioneel.

    Claude Opus 5-context van 1M

    anthropic/claude-opus-5 en de claude-cli-variant hebben standaard een contextvenster van 1M; params.context1m: true is niet nodig.

    Probleemoplossing

    401-fouten / token plotseling ongeldig

    Anthropic-tokenauthenticatie verloopt en kan worden ingetrokken. Gebruik voor nieuwe configuraties in plaats daarvan een Anthropic API-sleutel.

    Geen API-sleutel gevonden voor provider "anthropic"

    Anthropic-authenticatie is per agent; nieuwe agents nemen de sleutels van de hoofdagent niet over. Voer de onboarding opnieuw uit voor die agent (of configureer een API-sleutel op de Gateway-host) en verifieer dit vervolgens met openclaw models status.

    Geen inloggegevens gevonden voor profiel "anthropic:default"

    Voer openclaw models status uit om te zien welk authenticatieprofiel actief is. Voer de onboarding opnieuw uit of configureer een API-sleutel voor dat profielpad.

    Geen beschikbaar authenticatieprofiel (allemaal in afkoelperiode)

    Controleer openclaw models status --json voor auth.unusableProfiles. Afkoelperioden vanwege Anthropic-snelheidslimieten kunnen modelspecifiek zijn, waardoor een verwant Anthropic-model mogelijk nog wel bruikbaar is. Voeg een ander Anthropic-profiel toe of wacht tot de afkoelperiode voorbij is.

    Gerelateerd

    Was this useful?
    On this page

    On this page