Providers
Anthropic
Anthropic bouwt de Claude-modelfamilie. OpenClaw ondersteunt twee auth-routes:
- API key — directe Anthropic API-toegang met gebruiksgebaseerde facturering (
anthropic/*-modellen) - Claude CLI — hergebruik een bestaande Claude CLI-login op dezelfde host
Aan de slag
API key
Beste voor: standaard API-toegang en gebruiksgebaseerde facturering.
Get your API key
Maak een API key aan in de Anthropic Console.
Run onboarding
openclaw onboard
# choose: Anthropic API key
Of geef de sleutel direct door:
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
Verify the model is available
openclaw models list --provider anthropic
Configuratievoorbeeld
{
env: { ANTHROPIC_API_KEY: "sk-ant-..." },
agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}
Claude CLI
Beste voor: hergebruik van een bestaande Claude CLI-login zonder aparte API key.
Ensure Claude CLI is installed and logged in
Controleer met:
claude --version
Run onboarding
openclaw onboard
# choose: Claude CLI
OpenClaw detecteert en hergebruikt de bestaande Claude CLI-referenties.
Verify the model is available
openclaw models list --provider anthropic
Configuratievoorbeeld
Geef de voorkeur aan de canonieke Anthropic-modelreferentie plus een CLI-runtime-override:
{
agents: {
defaults: {
model: { primary: "anthropic/claude-opus-4-7" },
agentRuntime: { id: "claude-cli" },
},
},
}
Verouderde claude-cli/claude-opus-4-7-modelreferenties blijven werken voor
compatibiliteit, maar nieuwe configuratie moet provider/modelselectie houden als
anthropic/* en de uitvoeringsbackend in agentRuntime.id zetten.
Denkstandaarden (Claude 4.6)
Claude 4.6-modellen gebruiken standaard adaptive denken in OpenClaw wanneer er geen expliciet denkniveau is ingesteld.
Overschrijf per bericht met /think:<level> of in modelparameters:
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": {
params: { thinking: "adaptive" },
},
},
},
},
}
Promptcaching
OpenClaw ondersteunt Anthropic's promptcachingfunctie voor auth met API key.
| Waarde | Cacheduur | Beschrijving |
|---|---|---|
"short" (default) |
5 minuten | Automatisch toegepast voor auth met API key |
"long" |
1 uur | Uitgebreide cache |
"none" |
Geen caching | Promptcaching uitschakelen |
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": {
params: { cacheRetention: "long" },
},
},
},
},
}
Per-agent cache overrides
Gebruik parameters op modelniveau als basis 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" } },
],
},
}
Samenvoegvolgorde van configuratie:
agents.defaults.models["provider/model"].paramsagents.list[].params(overeenkomendeid, overschrijft per sleutel)
Zo kan één agent een langlevende cache behouden terwijl een andere agent op hetzelfde model caching uitschakelt voor piekverkeer of verkeer met weinig hergebruik.
Bedrock Claude notes
- 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 standaarden voor API keys vullen ook
cacheRetention: "short"in voor Claude-op-Bedrock-referenties wanneer er geen expliciete waarde is ingesteld.
Geavanceerde configuratie
Fast mode
De gedeelde /fast-schakelaar van OpenClaw ondersteunt direct Anthropic-verkeer (API key en OAuth naar api.anthropic.com).
| Opdracht | Komt overeen met |
|---|---|
/fast on |
service_tier: "auto" |
/fast off |
service_tier: "standard_only" |
{
agents: {
defaults: {
models: {
"anthropic/claude-sonnet-4-6": {
params: { fastMode: true },
},
},
},
},
}
Media understanding (image and PDF)
De gebundelde Anthropic-Plugin registreert begrip van afbeeldingen en PDF's. OpenClaw lost mediacapaciteiten automatisch op vanuit de geconfigureerde Anthropic-auth — er is geen aanvullende configuratie nodig.
| Eigenschap | Waarde |
|---|---|
| Standaardmodel | claude-opus-4-7 |
| Ondersteunde invoer | Afbeeldingen, PDF-documenten |
Wanneer een afbeelding of PDF aan een gesprek wordt toegevoegd, routeert OpenClaw deze automatisch via de Anthropic-provider voor mediabegrip.
1M context window (beta)
Anthropic's 1M-contextvenster zit achter een bètapoort. Schakel het per model in:
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": {
params: { context1m: true },
},
},
},
},
}
OpenClaw zet dit op verzoeken om naar anthropic-beta: context-1m-2025-08-07.
params.context1m: true geldt ook voor de Claude CLI-backend
(claude-cli/*) voor geschikte Opus- en Sonnet-modellen, waardoor het runtime-
contextvenster voor die CLI-sessies wordt uitgebreid zodat het overeenkomt met het directe API-gedrag.
Claude Opus 4.7 1M context
anthropic/claude-opus-4.7 en de claude-cli-variant daarvan hebben standaard een 1M-context
venster — geen params.context1m: true nodig.
Probleemoplossing
401 errors / token suddenly invalid
Anthropic-tokenauth verloopt en kan worden ingetrokken. Gebruik voor nieuwe installaties in plaats daarvan een Anthropic API key.
No API key found for provider "anthropic"
Anthropic-auth is per agent — nieuwe agents nemen de sleutels van de hoofdagent niet over. Voer onboarding opnieuw uit voor die agent (of configureer een API key op de gatewayhost) en controleer vervolgens met openclaw models status.
No credentials found for profile "anthropic:default"
Voer openclaw models status uit om te zien welk auth-profiel actief is. Voer onboarding opnieuw uit, of configureer een API key voor dat profielpad.
No available auth profile (all in cooldown)
Controleer openclaw models status --json op auth.unusableProfiles. Anthropic-rate-limit-cooldowns kunnen modelgebonden zijn, dus een verwant Anthropic-model kan nog steeds bruikbaar zijn. Voeg een ander Anthropic-profiel toe of wacht tot de cooldown voorbij is.