Anthropic (Claude)¶
Anthropic bygger Claude modelfamilien og giver adgang via en API. I OpenClaw kan du godkende med en API-nøgle eller en setup-token.
Valgmulighed A: Anthropic API-nøgle¶
Bedst for: standard API-adgang og brugerbaseret fakturering. Opret din API-nøgle i den antropiske konsol.
CLI-opsætning¶
openclaw onboard
# choose: Anthropic API key
# or non-interactive
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
Konfigurationsudsnit¶
{
env: { ANTHROPIC_API_KEY: "sk-ant-..." },
agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}
Caching af prompts (Anthropic API)¶
OpenClaw understøtter Anthropic's prompt caching funktion. Dette er API-kun; abonnementsauth ærer ikke cache-indstillinger.
Konfiguration¶
Brug parameteren cacheRetention i din modelkonfiguration:
| Værdi | Cachevarighed | Beskrivelse |
|---|---|---|
none |
Ingen caching | Deaktiver prompt caching |
short |
5 minutter | Standard for API-nøgle-autentificering |
long |
1 time | Udvidet cache (kræver beta-flag) |
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": {
params: { cacheRetention: "long" },
},
},
},
},
}
Standarder¶
Ved brug af antropisk API-nøgle-godkendelse anvender OpenClaw automatisk cacheRetention: "short" (5-minutters cache) for alle antropiske modeller. Du kan tilsidesætte dette ved udtrykkeligt at indstille cacheRetention i din konfiguration.
Ældre parameter¶
Den ældre parameter cacheControlTtl understøttes stadig for bagudkompatibilitet:
"5m"kortlægges tilshort"1h"kortlægges tillong
Vi anbefaler at migrere til den nye parameter cacheRetention.
OpenClaw inkluderer extended-cache-ttl-2025-04-11 beta-flaget for Anthropic API-forespørgsler; behold det, hvis du tilsidesætter udbyder-headers (se /gateway/configuration).
Valgmulighed B: Claude setup-token¶
Bedst til: brug af dit Claude-abonnement.
Hvor får du et setup-token¶
Setup-tokens er skabt af Claude Code CLI, ikke den antropiske konsol. Du kan køre dette på enhver maskine:
claude setup-token
Indsæt tokenet i OpenClaw (opsætningsguide: Anthropic token (indsæt setup-token)), eller kør det på gateway-værten:
openclaw models auth setup-token --provider anthropic
Hvis du genererede tokenet på en anden maskine, så indsæt det:
openclaw models auth paste-token --provider anthropic
CLI-opsætning (setup-token)¶
# Paste a setup-token during onboarding
openclaw onboard --auth-choice setup-token
Konfigurationsudsnit (setup-token)¶
{
agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}
Noter¶
- Generér setup-tokenet med
claude setup-tokenog indsæt det, eller køropenclaw models auth setup-tokenpå gateway-værten. - Hvis du ser “OAuth token refresh mislykkedes …” på et Claude abonnement, re-auth med en setup-token. Se /gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription.
- Autentificeringsdetaljer + genbrugsregler findes i /concepts/oauth.
Fejlfinding¶
401-fejl / token pludselig ugyldigt
- Claude abonnementsauth kan udløbe eller tilbagekaldes. Re-run
claude setup-tokenog indsæt det i gateway host. - Hvis Claude CLI-login findes på en anden maskine, så brug
openclaw models auth paste-token --provider anthropicpå gateway-værten.
Ingen API-nøgle fundet for udbyderen "anthropic"
- Auth er per agent. Nye agenter arver ikke hovedagentens nøgler.
- Kør introduktionen igen for den agent, eller indsæt et setup-token / en API-nøgle på
gateway-værten, og verificér derefter med
openclaw models status.
Ingen legitimationsoplysninger fundet for profilen anthropic:default
- Kør
openclaw models statusfor at se, hvilken autentificeringsprofil der er aktiv. - Kør introduktionen igen, eller indsæt et setup-token / en API-nøgle for den profil.
Ingen tilgængelig autentificeringsprofil (alle i cooldown/utilgængelige)
- Tjek
openclaw models status --jsonforauth.unusableProfiles. - Tilføj en anden Anthropic-profil eller vent på cooldown.
Mere: /gateway/troubleshooting og /help/faq.