Anthropic

Anthropic crea 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 Code esistente sullo stesso host

Per iniziare

openclaw onboard# choose: Anthropic API key

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

openclaw models list --provider anthropic

{  env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" },  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },}

claude --version

openclaw onboard# choose: Claude CLI

openclaw models list --provider anthropic

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

Valori predefiniti di thinking (Claude Fable 5, 4.8 e 4.6)

anthropic/claude-fable-5 usa sempre thinking adattivo e per impostazione predefinita usa lo sforzo high. Poiché Anthropic non consente di disabilitare thinking per questo modello, /think off e /think minimal usano lo sforzo low. OpenClaw omette anche i valori personalizzati di temperatura per le richieste Fable 5.

Claude Opus 4.8 mantiene thinking disattivato per impostazione predefinita in OpenClaw. Quando abiliti esplicitamente thinking adattivo con /think high|xhigh|max, OpenClaw invia i valori di sforzo Opus 4.8 di Anthropic; i modelli Claude 4.6 hanno come impostazione predefinita adaptive.

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

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

Fallback per rifiuti di sicurezza (Claude Fable 5)

Perché esiste

I classificatori Fable 5 restituiscono stop_reason: "refusal" su richieste in domini soggetti a restrizioni, e producono anche falsi positivi su attività benign-adjacent (strumenti di sicurezza, scienze della vita o persino chiedere al modello di riprodurre il suo ragionamento grezzo). Senza un fallback, il turno termina con un errore anche se un altro modello Claude lo servirebbe senza problemi — il messaggio di rifiuto di Anthropic indica agli integratori API di configurare un modello di fallback.

Come funziona

1. Per ogni richiesta diretta con chiave API a anthropic/claude-fable-5, OpenClaw invia l'opt-in al fallback lato server di Anthropic: l'header beta server-side-fallback-2026-06-01 più fallbacks: [{"model": "claude-opus-4-8"}]. Claude Opus 4.8 è l'unico target di fallback consentito da Anthropic per Fable 5.
2. Solo un rifiuto del classificatore di sicurezza attiva il fallback. Rate limit, sovraccarichi ed errori server si comportano esattamente come prima e passano attraverso il normale failover del modello di OpenClaw.
3. Il recupero avviene all'interno della stessa chiamata. Un rifiuto prima di qualsiasi output è invisibile a parte la latenza; l'intera risposta arriva da Opus 4.8. In caso di rifiuto a metà streaming, il testo parziale viene mantenuto come prefisso da cui continua il modello di fallback, mentre il ragionamento e le chiamate agli strumenti del modello che ha rifiutato vengono scartati secondo le regole di replay di Anthropic (non devono essere rimandati indietro né eseguiti).
4. Se anche Claude Opus 4.8 rifiuta, il turno espone il rifiuto come errore, esattamente come prima di questa funzionalità.

Il fallback avviene a livello dell'API Anthropic, quindi claude-opus-4-8 non deve trovarsi nell'elenco dei modelli configurati o nella catena di fallback — una chiave API abilitata a Fable può sempre servire Opus.

Osservabilità e fatturazione

• Un turno servito tramite fallback registra un diagnostico provider_fallback sul messaggio dell'assistente indicando fromModel e toModel, e il responseModel del messaggio riporta claude-opus-4-8.
• Anthropic fattura per tentativo: un rifiuto prima dell'output è gratuito e il recupero viene fatturato alle tariffe di Claude Opus 4.8 (attualmente la metà delle tariffe Fable 5). La stima dei costi per turno di OpenClaw prezza i turni serviti tramite fallback alle tariffe Opus per corrispondere.
• Un rifiuto a metà streaming fattura inoltre il parziale Fable già trasmesso lato Anthropic; quella porzione è riportata nell'utilizzo per tentativo dell'API ma non viene inclusa nella stima per turno di OpenClaw.

Ambito

Si applica a anthropic/claude-fable-5 con autenticazione tramite chiave API verso api.anthropic.com. OAuth (riutilizzo dell'abbonamento Claude CLI), URL base proxy, Bedrock, Vertex e richieste Foundry restano invariati e continuano a esporre i rifiuti come errori lì.

Verificato live: un prompt benigno che chiede a Fable 5 di riprodurre la sua catena di pensiero grezza viene rifiutato con category: "reasoning_extraction" quando inviato senza fallback, e lo stesso prompt tramite OpenClaw restituisce una normale risposta servita da Opus con il diagnostico provider_fallback allegato.

Consulta la guida a rifiuti e fallback di Anthropic per il comportamento sottostante.

Caching dei prompt

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

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

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

Configurazione avanzata

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

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

Risoluzione dei problemi

Correlati