Hoppa till huvudinnehåll

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:
VärdeCache-varaktighetBeskrivning
noneIngen cachingInaktivera prompt-caching
short5 minuterStandard för API-nyckelautentisering
long1 timmeUtökad cache (kräver beta-flagga)
{
  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

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.