Anthropic

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

• Chiave API - accesso diretto all'API Anthropic con fatturazione basata sull'utilizzo (modelli anthropic/*)
• Claude CLI - riutilizzo di un accesso Claude Code esistente sullo stesso host

Monitoraggio dell'utilizzo e dei costi

OpenClaw rileva la credenziale Anthropic disponibile e seleziona la relativa modalità di visualizzazione dell'utilizzo:

• Le credenziali di abbonamento/configurazione Claude mostrano le finestre di quota e il budget facoltativo per l'utilizzo aggiuntivo.
• ANTHROPIC_ADMIN_KEY o ANTHROPIC_ADMIN_API_KEY mostra 30 giorni di costi dell'organizzazione comunicati dal provider e di utilizzo dell'API Messages nella sezione Utilizzo della Control UI, inclusi spesa giornaliera, totali di token/cache, modelli principali e categorie di costo.
• Una credenziale sk-ant-admin... memorizzata nel profilo del provider Anthropic viene rilevata automaticamente come chiave API Admin.

La cronologia dei costi dell'API Admin proviene dall'API Usage and Cost di Anthropic. Rappresenta la fatturazione effettiva del provider, distinta dal costo stimato da OpenClaw in base alle sessioni.

Introduzione

openclaw onboard# scegliere: chiave API Anthropic

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# scegliere: Claude CLI

openclaw models list --provider anthropic

openclaw models auth login --provider anthropic --method setup-token

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

Sessioni Claude su più computer

Il plugin Anthropic incluso aggiunge un gruppo Claude Code alla normale barra laterale delle sessioni. Le righe si aprono nel normale pannello Chat. Il plugin rileva le sessioni Claude Code non archiviate sul Gateway e sugli host Node connessi:

• Le sessioni Claude CLI provengono da record validi dell'indice dei progetti e da file JSONL correnti il cui prefisso limitato di metadati identifica una sessione sdk-cli non sidechain in ~/.claude/projects/.
• Le sessioni Claude Desktop utilizzano il titolo Desktop, l'ora dell'attività e lo stato di archiviazione quando i relativi metadati puntano allo stesso ID sessione Claude Code.
• Una sessione disponibile solo tramite CLI non ha un indicatore di archiviazione, pertanto rimane visibile finché è presente la relativa trascrizione.

Non è necessaria alcuna configurazione aggiuntiva di OpenClaw per il rilevamento. Il plugin Anthropic è incluso e abilitato per impostazione predefinita; un Node macOS nativo pubblicizza i comandi di sola lettura per le sessioni Claude quando esiste la directory locale ~/.claude/projects/. Approvare l'aggiornamento dell'associazione del Node quando tali comandi vengono visualizzati per la prima volta.

La barra laterale raggruppa le righe in base al rispettivo Gateway o host Node associato, inizia dalla pagina limitata più recente di ciascun host e si aggiorna secondo la normale cadenza di 30 secondi. Utilizzare Carica altre sessioni sotto un gruppo del catalogo per aggiungere la pagina successiva per ogni host con altra cronologia disponibile; le righe aggiunte rimangono visibili e vengono recuperate nuovamente alla stessa profondità durante gli aggiornamenti. I client del catalogo utilizzano sessions.catalog.list; l'apertura di una riga utilizza sessions.catalog.read.

L'acquisizione del controllo del terminale risolve claude dal PATH della shell di login dell'utente dell'host proprietario prima del PATH del servizio/daemon. In questo modo, le sessioni avviate dall'app rimangono allineate con la Claude CLI disponibile all'operatore in un normale terminale.

Quando si seleziona una riga, viene letta per prima la pagina più recente della trascrizione. Carica elementi precedenti della trascrizione segue un cursore di byte opaco e legge un'altra sezione limitata dal file JSONL anziché caricare l'intera cronologia. Vengono preservati i normali contenuti di utente, assistente, ragionamento, chiamata di strumenti e risultato degli strumenti. Un singolo elemento più grande del limite di sicurezza del Node/Gateway viene chiaramente contrassegnato come troncato.

Per una riga claude-cli locale al Gateway, la digitazione nel normale compositore chiama sessions.catalog.continue. OpenClaw risolve nuovamente il record locale del catalogo, crea o riutilizza una sessione nativa vincolata al modello, importa al massimo 200 elementi visibili o 512 KiB e inizializza il binding Claude CLI. Il primo turno riprende con --fork-session; Claude assegna al fork un nuovo ID sessione, pertanto i turni successivi utilizzano il fork e la sessione di origine rimane invariata.

Anche un host Node headless può rendere proseguibili le proprie righe Claude CLI abilitando l'impostazione locale del Node riportata di seguito e riavviando l'host Node:

{  nodeHost: {    agentRuns: {      claude: { enabled: true },    },  },}

Il Node pubblicizza agent.cli.claude.run.v1 solo quando l'impostazione è abilitata e il relativo eseguibile locale claude viene risolto. OpenClaw risolve nuovamente il record del catalogo su quel Node, importa la stessa cronologia limitata e associa la sessione adottata al Node e alla directory di lavoro indicata dal catalogo. Ogni turno esegue il processo claude -p effettivo del Node utilizzando i file Claude e l'accesso di quel Node. I criteri di approvazione dell'esecuzione del Node continuano ad applicarsi; il Gateway non può forzare l'adesione.

La continuazione Node v1 è esclusivamente una tantum. Omette la configurazione MCP di loopback del Gateway e gli argomenti del plugin Skills del Gateway, non esegue una nuova inizializzazione da una trascrizione del Gateway e rifiuta allegati e immagini. Le righe Claude Desktop rimangono di sola visualizzazione. Anche i Node dell'app macOS nativa rimangono di sola visualizzazione finché l'app non pubblicizza il comando di esecuzione.

Consultare Node: sessioni e trascrizioni Claude per il comando del Node e il confine di sicurezza.

Impostazioni predefinite di ragionamento (Claude Sonnet 5, Mythos 5, Fable 5, 4.8 e 4.6)

anthropic/claude-sonnet-5 usa per impostazione predefinita il pensiero adattivo con un livello di impegno high. Usare /think off per disabilitare il pensiero oppure /think xhigh|max per i livelli di impegno nativi superiori del modello. OpenClaw omette i budget di pensiero manuali, i parametri di campionamento personalizzati, i prefill dell'assistente e Priority Tier per Sonnet 5 perché Anthropic non supporta queste funzionalità di richiesta su questo modello. Il catalogo usa i prezzi introduttivi di Anthropic per input/output pari a $2/$10 fino al 31 agosto 2026; i prezzi standard di $3/$15 iniziano il 1° settembre 2026.

anthropic/claude-fable-5 usa sempre il pensiero adattivo e ha come livello di impegno predefinito high. Anthropic non consente di disabilitare il pensiero per questo modello, pertanto /think off e /think minimal vengono invece associati al livello di impegno low. OpenClaw omette inoltre i valori di temperatura personalizzati per le richieste Fable 5, poiché Anthropic rifiuta la sostituzione della temperatura in qualsiasi richiesta con il pensiero abilitato.

anthropic/claude-mythos-5 è un modello ad accesso limitato con lo stesso contratto di pensiero adattivo sempre attivo. OpenClaw usa per impostazione predefinita high, associa /think off e /think minimal a low e omette i parametri di campionamento selezionati dal chiamante. Il catalogo pubblica la sua finestra di contesto da 1.000.000 di token, il limite di output da 128.000 token, l'input di immagini e i prezzi di input/output pari a $10/$50.

Per Claude Opus 4.8 il pensiero rimane disattivato per impostazione predefinita in OpenClaw. Quando si abilita esplicitamente il pensiero adattivo con /think high|xhigh|max, OpenClaw invia i valori di impegno di Anthropic per Opus 4.8; i modelli Claude 4.6 (Opus 4.6 e Sonnet 4.6) usano per impostazione predefinita adaptive.

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

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

Fallback in caso di rifiuto per motivi di sicurezza (Claude Fable 5)

Perché esiste

I classificatori di Fable 5 restituiscono stop_reason: "refusal" per le richieste in ambiti soggetti a restrizioni e producono anche falsi positivi per attività lecite ma adiacenti (strumenti di sicurezza, scienze della vita o persino richieste al modello di riprodurre il proprio ragionamento grezzo). Senza un fallback, il turno termina con un errore anche se un altro modello Claude potrebbe gestirlo senza problemi: il messaggio di rifiuto di Anthropic indica agli integratori API di configurare un modello di fallback.

Funzionamento

1. Per ogni richiesta diretta con chiave API a anthropic/claude-fable-5, OpenClaw invia l'adesione al fallback lato server di Anthropic: l'header beta server-side-fallback-2026-06-01 insieme a fallbacks: [{"model": "claude-opus-4-8"}]. Claude Opus 4.8 è l'unica destinazione di fallback consentita da Anthropic per Fable 5.
2. Solo un rifiuto del classificatore di sicurezza attiva il fallback. Limiti di frequenza, sovraccarichi ed errori del 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 proviene da Opus 4.8. In caso di rifiuto durante lo streaming, il testo parziale viene mantenuto come prefisso dal quale il modello di fallback prosegue, mentre il ragionamento e le chiamate agli strumenti del modello che ha rifiutato vengono scartati secondo le regole di riproduzione di Anthropic (non devono essere restituiti 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 essere presente nell'elenco dei modelli configurati o nella catena di fallback: una chiave API compatibile con Fable può sempre usare Opus.

Osservabilità e fatturazione

• Un turno gestito tramite fallback registra un'informazione diagnostica provider_fallback nel messaggio dell'assistente, indicando fromModel e toModel, mentre il valore 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 pari alla metà delle tariffe di Fable 5). La stima dei costi per turno di OpenClaw calcola i turni gestiti tramite fallback alle tariffe di Opus.
• Un rifiuto durante lo streaming comporta inoltre la fatturazione, da parte di Anthropic, della parte già trasmessa in streaming da Fable; tale parte viene 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 di base proxy, richieste Bedrock, Vertex e Foundry rimangono invariate e continuano a esporre i rifiuti come errori.

Verifica dal vivo: una richiesta lecita che chiede a Fable 5 di riprodurre la propria catena di pensiero grezza viene rifiutata con category: "reasoning_extraction" quando viene inviata senza fallback, mentre la stessa richiesta tramite OpenClaw restituisce una normale risposta gestita da Opus con l'informazione diagnostica provider_fallback allegata.

Consultare la guida ai rifiuti e al fallback di Anthropic per il comportamento sottostante.

Caching dei prompt

OpenClaw supporta la funzionalità di caching dei prompt di Anthropic per l'autenticazione tramite 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-sonnet-5": {},        "anthropic/claude-mythos-5": {},        "anthropic/claude-opus-4-6": {},      },    },  },}

Risoluzione dei problemi

Correlati