Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 — riusa un login Claude CLI esistente sullo stesso host
Lo staff di Anthropic ci ha comunicato che l’uso in stile OpenClaw della Claude CLI è di nuovo consentito, quindi OpenClaw considera il riuso della Claude CLI e l’uso di claude -p autorizzati, salvo nuova policy pubblicata da Anthropic.Per host Gateway a lungo termine, le chiavi API Anthropic restano comunque il percorso di produzione più chiaro e prevedibile.Documentazione pubblica attuale di Anthropic:

​
Per iniziare

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

Ottieni la tua chiave API

Crea una chiave API nella Console Anthropic.
2

Esegui l'onboarding

openclaw onboard
# choose: Anthropic API key
Oppure passa direttamente la chiave:
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
3

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" } } },
}

​
Impostazioni predefinite del ragionamento (Claude 4.6)

I modelli Claude 4.6 usano per impostazione predefinita il ragionamento adaptive in OpenClaw quando non è impostato un 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" },
        },
      },
    },
  },
}
Documentazione Anthropic correlata:

​
Memorizzazione nella cache dei prompt

OpenClaw supporta la funzionalità di memorizzazione nella cache dei prompt di Anthropic per l’autenticazione con chiave API.
ValoreDurata cacheDescrizione
"short" (predefinito)5 minutiApplicata automaticamente per l’autenticazione con chiave API
"long"1 oraCache estesa
"none"Nessuna cacheDisattiva la memorizzazione nella cache dei prompt
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}
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 unione della configurazione:
  1. agents.defaults.models["provider/model"].params
  2. agents.list[].params (id corrispondente, override per chiave)
Questo consente a un agente di mantenere una cache a lunga durata mentre un altro agente sullo stesso modello disattiva la cache per traffico a raffiche o con basso riuso.
  • I modelli Anthropic Claude su Bedrock (amazon-bedrock/*anthropic.claude*) accettano il pass-through di cacheRetention quando configurato.
  • I modelli Bedrock non Anthropic sono forzati a cacheRetention: "none" a 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

Il toggle condiviso /fast di OpenClaw supporta il traffico Anthropic diretto (chiave API e OAuth verso api.anthropic.com).
ComandoMappa a
/fast onservice_tier: "auto"
/fast offservice_tier: "standard_only"
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}
  • Iniettato solo per richieste dirette a api.anthropic.com. Le route proxy lasciano service_tier invariato.
  • I parametri espliciti serviceTier o service_tier eseguono l’override di /fast quando sono entrambi impostati.
  • Sugli account senza capacità Priority Tier, service_tier: "auto" può risolversi in standard.
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 predefinitoclaude-opus-4-7
Input supportatoImmagini, documenti PDF
Quando un’immagine o un PDF è allegato a una conversazione, OpenClaw lo instrada automaticamente tramite il provider di comprensione multimediale Anthropic.
La finestra di contesto 1M di Anthropic è vincolata alla beta. 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 API diretto.
Richiede l’accesso al contesto lungo sulla tua credenziale Anthropic. L’autenticazione token legacy (sk-ant-oat-*) viene rifiutata per le richieste di contesto 1M: OpenClaw registra un avviso e ripiega sulla finestra di contesto standard.
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

L’autenticazione token Anthropic scade e può essere revocata. Per nuove configurazioni, usa invece una chiave API Anthropic.
L’autenticazione Anthropic è per agente: i nuovi agenti non ereditano le chiavi dell’agente principale. Riesegui l’onboarding per quell’agente (o configura una chiave API sull’host Gateway), quindi verifica con openclaw models status.
Esegui openclaw models status per vedere quale profilo di autenticazione è attivo. Riesegui l’onboarding oppure configura una chiave API per quel percorso di profilo.
Controlla openclaw models status --json per auth.unusableProfiles. I cooldown dei limiti di frequenza Anthropic possono essere specifici del modello, quindi un modello Anthropic affine potrebbe essere ancora utilizzabile. Aggiungi un altro profilo Anthropic o attendi il cooldown.
Altro aiuto: Risoluzione dei problemi e FAQ.

​
Correlati

Selezione del modello

Scelta di provider, riferimenti modello e comportamento di failover.

Backend CLI

Configurazione del backend Claude CLI e dettagli runtime.

Memorizzazione nella cache dei prompt

Come funziona la memorizzazione nella cache dei prompt tra provider.

OAuth e autenticazione

Dettagli di autenticazione e regole di riuso delle credenziali.