Providers

Anthropic

Anthropic sviluppa la famiglia di modelli Claude. OpenClaw supporta due percorsi di autenticazione:

Chiave API — accesso diretto all'API Anthropic con fatturazione basata sull'utilizzo (modelli anthropic/*)
Claude CLI — riutilizza un login Claude CLI esistente sullo stesso host

Per iniziare

Chiave API

Ideale per: accesso API standard e fatturazione basata sull'utilizzo.

Ottieni la tua chiave API

Crea una chiave API nella Console Anthropic.

Esegui l'onboarding

openclaw onboard
# choose: Anthropic API key

Oppure passa direttamente la chiave:

openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

Verifica che il modello sia disponibile

openclaw models list --provider anthropic

Esempio di configurazione

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

Claude CLI

Ideale per: riutilizzare un login Claude CLI esistente senza una chiave API separata.

Assicurati che Claude CLI sia installato e con accesso effettuato

Verifica con:

claude --version

Esegui l'onboarding

openclaw onboard
# choose: Claude CLI

OpenClaw rileva e riutilizza le credenziali Claude CLI esistenti.

Verifica che il modello sia disponibile

openclaw models list --provider anthropic

Esempio di configurazione

Preferisci il riferimento canonico al modello Anthropic più un override del runtime CLI:

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-7" },
      agentRuntime: { id: "claude-cli" },
    },
  },
}

I riferimenti modello legacy claude-cli/claude-opus-4-7 continuano a funzionare per compatibilità, ma le nuove configurazioni dovrebbero mantenere la selezione provider/modello come anthropic/* e inserire il backend di esecuzione in agentRuntime.id.

Impostazioni predefinite di ragionamento (Claude 4.6)

I modelli Claude 4.6 usano per impostazione predefinita il ragionamento adaptive in OpenClaw quando non è impostato alcun livello di ragionamento esplicito.

Esegui l'override per messaggio con /think:<level> o nei parametri del modello:

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

Cache dei prompt

OpenClaw supporta la funzionalità di cache dei prompt di Anthropic per l'autenticazione con chiave API.

Valore	Durata cache	Descrizione
`"short"` (predefinito)	5 minuti	Applicata automaticamente per l'autenticazione con chiave API
`"long"`	1 ora	Cache estesa
`"none"`	Nessuna cache	Disabilita la cache dei prompt

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

Override cache per agente

Usa i parametri a livello di modello come baseline, quindi esegui l'override di agenti specifici tramite 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" } },
    ],
  },
}

Ordine di merge della configurazione:

agents.defaults.models["provider/model"].params
agents.list[].params (id corrispondente, override per chiave)

Questo consente a un agente di mantenere una cache di lunga durata mentre un altro agente sullo stesso modello disabilita la cache per traffico a raffiche o con scarso riutilizzo.

Note su Bedrock Claude

I modelli Anthropic Claude su Bedrock (amazon-bedrock/*anthropic.claude*) accettano il pass-through di cacheRetention quando configurato.
I modelli Bedrock non Anthropic vengono forzati a cacheRetention: "none" in runtime.
Le impostazioni predefinite intelligenti per chiave API inizializzano anche cacheRetention: "short" per i riferimenti Claude-on-Bedrock quando non è impostato alcun valore esplicito.

Configurazione avanzata

Modalità veloce

Il toggle condiviso /fast di OpenClaw supporta traffico Anthropic diretto (chiave API e OAuth verso api.anthropic.com).

Comando	Mappa a
`/fast on`	`service_tier: "auto"`
`/fast off`	`service_tier: "standard_only"`

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}

Comprensione dei media (immagini e PDF)

Il Plugin Anthropic incluso registra la comprensione di immagini e PDF. OpenClaw risolve automaticamente le capacità multimediali dall'autenticazione Anthropic configurata: non è necessaria alcuna configurazione aggiuntiva.

Proprietà	Valore
Modello predefinito	`claude-opus-4-7`
Input supportato	Immagini, documenti PDF

Quando un'immagine o un PDF viene allegato a una conversazione, OpenClaw lo instrada automaticamente tramite il provider di comprensione media Anthropic.

Finestra di contesto 1M (beta)

La finestra di contesto 1M di Anthropic è protetta da beta gate. Abilitala per modello:

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

OpenClaw la mappa a anthropic-beta: context-1m-2025-08-07 nelle richieste.

params.context1m: true si applica anche al backend Claude CLI (claude-cli/*) per i modelli Opus e Sonnet idonei, espandendo la finestra di contesto runtime per quelle sessioni CLI in modo che corrisponda al comportamento dell'API diretta.

Contesto 1M di Claude Opus 4.7

anthropic/claude-opus-4.7 e la sua variante claude-cli hanno una finestra di contesto 1M per impostazione predefinita: non serve params.context1m: true.

Risoluzione dei problemi

Errori 401 / token improvvisamente non valido

L'autenticazione token Anthropic scade e può essere revocata. Per nuove configurazioni, usa invece una chiave API Anthropic.

Nessuna chiave API trovata per il provider "anthropic"

L'autenticazione Anthropic è per agente: i nuovi agenti non ereditano le chiavi dell'agente principale. Esegui di nuovo l'onboarding per quell'agente (oppure configura una chiave API sull'host Gateway), quindi verifica con openclaw models status.

Nessuna credenziale trovata per il profilo "anthropic:default"

Esegui openclaw models status per vedere quale profilo di autenticazione è attivo. Esegui di nuovo l'onboarding oppure configura una chiave API per quel percorso profilo.

Nessun profilo di autenticazione disponibile (tutti in cooldown)

Controlla openclaw models status --json per auth.unusableProfiles. I cooldown da rate limit Anthropic possono essere limitati al modello, quindi un modello Anthropic associato potrebbe essere ancora utilizzabile. Aggiungi un altro profilo Anthropic o attendi il cooldown.

Correlati

Selezione del modello

Scelta di provider, riferimenti modello e comportamento di failover.

Backend CLI

Dettagli di configurazione e runtime del backend Claude CLI.

Cache dei prompt

Come funziona la cache dei prompt tra provider.

OAuth e autenticazione

Dettagli di autenticazione e regole di riutilizzo delle credenziali.

# Per iniziare

Chiave API

Ottieni la tua chiave API

Esegui l'onboarding

Verifica che il modello sia disponibile

# Esempio di configurazione

Claude CLI

Assicurati che Claude CLI sia installato e con accesso effettuato

Esegui l'onboarding

Verifica che il modello sia disponibile

# Esempio di configurazione

# Impostazioni predefinite di ragionamento (Claude 4.6)

# Cache dei prompt

# Configurazione avanzata

# Risoluzione dei problemi

# Correlati

Per iniziare

Esempio di configurazione

Esempio di configurazione

Impostazioni predefinite di ragionamento (Claude 4.6)

Cache dei prompt

Configurazione avanzata

Risoluzione dei problemi

Correlati