Anthropic (Claude)¶

Antropisk bygger Claude modellfamilj och ger åtkomst via ett API. I OpenClaw kan du autentisera med en API-nyckel eller en setup-token.

Alternativ A: Anthropic API-nyckel¶

Bäst för: standard API-åtkomst och användningsbaserad fakturering. Skapa din API-nyckel i Antropiska konsolen.

CLI-konfigurering¶

openclaw onboard
# choose: Anthropic API key

# or non-interactive
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

Konfigutdrag¶

{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

Prompt-caching (Anthropic API)¶

OpenClaw stöder Anthropic's prompt caching funktion. Detta är API-bara; prenumeration auth hedrar inte cacheinställningar.

Konfiguration¶

Använd parametern cacheRetention i din modellkonfig:

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}

Standardvärden¶

Vid användning av Anthropic API-nyckel autentisering tillämpar OpenClaw automatiskt cacheRetention: "short" (5-minuters cache) för alla antropiska modeller. Du kan åsidosätta detta genom att uttryckligen sätta cacheRetention i din konfiguration.

Äldre parameter¶

Den äldre parametern cacheControlTtl stöds fortfarande för bakåtkompatibilitet:

• "5m" mappar till short
• "1h" mappar till long

Vi rekommenderar att du migrerar till den nya parametern cacheRetention.

OpenClaw inkluderar beta-flaggan extended-cache-ttl-2025-04-11 för Anthropic API-förfrågningar; behåll den om du åsidosätter leverantörshuvuden (se /gateway/configuration).

Alternativ B: Claude setup-token¶

Bäst för: att använda din Claude-prenumeration.

Var får man en setup-token¶

Setup-tokens är skapade av Claude Code CLI, inte Anthropic Console. Du kan köra detta på alla maskiner:

claude setup-token

Klistra in token i OpenClaw (guide: Anthropic token (klistra in setup-token)), eller kör det på gateway-värden:

openclaw models auth setup-token --provider anthropic

Om du genererade token på en annan maskin, klistra in den:

openclaw models auth paste-token --provider anthropic

CLI-konfigurering (setup-token)¶

# Paste a setup-token during onboarding
openclaw onboard --auth-choice setup-token

Konfigutdrag (setup-token)¶

{
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

Noteringar¶

• Generera setup-token med claude setup-token och klistra in den, eller kör openclaw models auth setup-token på gateway-värden.
• Om du ser “OAuth token update failed …” på en Claude prenumeration, re-auth med en setup-token. Se /gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription.
• Autentiseringsdetaljer + regler för återanvändning finns i /concepts/oauth.

Felsökning¶

401-fel / token plötsligt ogiltig

• Claude prenumeration auth kan upphöra eller återkallas. Återkörd claude setup-token och klistra in den i gateway host.
• Om inloggningen för Claude CLI finns på en annan maskin, använd openclaw models auth paste-token --provider anthropic på gateway-värden.

Ingen API-nyckel hittades för leverantören ”anthropic”

• Auth är per agent. Nya agenter ärver inte huvudagentens nycklar.
• Kör introduktionen igen för den agenten, eller klistra in en setup-token / API-nyckel på gateway-värden och verifiera sedan med openclaw models status.

Inga autentiseringsuppgifter hittades för profilen anthropic:default

• Kör openclaw models status för att se vilken autentiseringsprofil som är aktiv.
• Kör introduktionen igen, eller klistra in en setup-token / API-nyckel för den profilen.

Ingen tillgänglig autentiseringsprofil (alla i cooldown/otillgängliga)

• Kontrollera openclaw models status --json för auth.unusableProfiles.
• Lägg till en annan Anthropic-profil eller vänta tills cooldownen är över.

Mer: /gateway/troubleshooting och /help/faq.