Anthropic

• 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

• 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.

​

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

• 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.

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

​

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

{
  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

​

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à.

​

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

​

Caching dei prompt

{
  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