​

Anthropic (Claude)

​

Opzione A: chiave API Anthropic

​

Configurazione CLI

openclaw onboard
# scegli: Anthropic API key

# oppure non interattivo
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

​

Snippet di configurazione Claude CLI

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

​

Valori predefiniti di thinking (Claude 4.6)

• I modelli Anthropic Claude 4.6 usano per impostazione predefinita il thinking adaptive in OpenClaw quando non è impostato alcun livello di thinking esplicito.
• Puoi sovrascriverlo per messaggio (/think:<level>) o nei parametri del modello: agents.defaults.models["anthropic/<model>"].params.thinking.
• Documentazione Anthropic correlata:
  • Adaptive thinking
  • Extended thinking

​

Modalità fast (Anthropic API)

• /fast on corrisponde a service_tier: "auto"
• /fast off corrisponde a service_tier: "standard_only"
• Configurazione predefinita:

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

• OpenClaw inietta i service tier Anthropic solo per richieste dirette a api.anthropic.com. Se instradi anthropic/* tramite un proxy o gateway, /fast lascia invariato service_tier.
• I parametri espliciti del modello Anthropic serviceTier o service_tier hanno precedenza sul valore predefinito di /fast quando sono entrambi impostati.
• Anthropic riporta il tier effettivo nella risposta sotto usage.service_tier. Negli account senza capacità Priority Tier, service_tier: "auto" può comunque risolversi in standard.

​

Prompt caching (Anthropic API)

​

Configurazione

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

​

Valori predefiniti

​

Override di cacheRetention per agente

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" }, // base per la maggior parte degli agenti
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } }, // override solo per questo agente
    ],
  },
}

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

​

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" a runtime.
• I valori predefiniti intelligenti della chiave API Anthropic impostano anche cacheRetention: "short" per i riferimenti di modello Claude-on-Bedrock quando non è impostato alcun valore esplicito.

​

Finestra di contesto 1M (beta Anthropic)

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

​

Opzione B: Claude CLI come provider di messaggi

• claude-cli/claude-sonnet-4-6
• claude-cli/claude-opus-4-6

1. OpenClaw avvia claude -p --output-format stream-json --include-partial-messages ... sull’host gateway e invia il prompt su stdin.
2. Il primo turno invia --session-id <uuid>.
3. I turni successivi riutilizzano la sessione Claude memorizzata tramite --resume <sessionId>.
4. I tuoi messaggi di chat passano comunque attraverso la normale pipeline di messaggi OpenClaw, ma la risposta effettiva del modello viene prodotta da Claude CLI.

​

Requisiti

• Claude CLI installato sull’host gateway e disponibile nel PATH, oppure configurato con un percorso assoluto del comando.
• Claude CLI già autenticato su quel medesimo host:

claude auth status

• OpenClaw carica automaticamente il plugin Anthropic incluso all’avvio del gateway quando la tua configurazione fa riferimento esplicito a claude-cli/... o alla configurazione backend claude-cli.

​

Snippet di configurazione

{
  agents: {
    defaults: {
      model: {
        primary: "claude-cli/claude-sonnet-4-6",
      },
      models: {
        "claude-cli/claude-sonnet-4-6": {},
      },
      sandbox: { mode: "off" },
    },
  },
}

{
  agents: {
    defaults: {
      cliBackends: {
        "claude-cli": {
          command: "/opt/homebrew/bin/claude",
        },
      },
    },
  },
}

​

Cosa ottieni

• Autenticazione dell’abbonamento Claude riutilizzata dalla CLI locale (letta a runtime, non mantenuta)
• Normale instradamento dei messaggi/sessioni OpenClaw
• Continuità di sessione Claude CLI tra i turni (invalidata in caso di cambiamenti di autenticazione)
• Strumenti Gateway esposti a Claude CLI tramite bridge MCP loopback
• Streaming JSONL con avanzamento live dei messaggi parziali

​

Migrare dall’autenticazione Anthropic a Claude CLI

• Claude CLI installato sul medesimo host gateway che esegue OpenClaw
• Claude CLI già autenticato lì: claude auth login

openclaw models auth login --provider anthropic --method cli --set-default

openclaw onboard --auth-choice anthropic-cli

• verifica che Claude CLI sia già autenticato sull’host gateway
• cambia il modello predefinito in claude-cli/...
• riscrive i fallback del modello predefinito Anthropic come anthropic/claude-opus-4-6 in claude-cli/claude-opus-4-6
• aggiunge voci claude-cli/... corrispondenti a agents.defaults.models

openclaw models status

• eliminare i tuoi profili di autenticazione Anthropic esistenti
• rimuovere ogni vecchio riferimento di configurazione anthropic/... al di fuori del percorso principale del modello predefinito/allowlist

​

Limiti importanti

• Questo non è il provider API Anthropic. È il runtime CLI locale.
• OpenClaw non inietta direttamente le chiamate agli strumenti. Claude CLI riceve gli strumenti gateway tramite un bridge MCP loopback (bundleMcp: true, il valore predefinito).
• Claude CLI trasmette le risposte via JSONL (stream-json con --include-partial-messages). I prompt vengono inviati su stdin, non su argv.
• L’autenticazione viene letta a runtime dalle credenziali Claude CLI live e non viene mantenuta nei profili OpenClaw. I prompt del portachiavi vengono soppressi nei contesti non interattivi.
• Il riuso della sessione viene tracciato tramite i metadati cliSessionBinding. Quando lo stato di login di Claude CLI cambia (nuovo login, rotazione del token), le sessioni memorizzate vengono invalidate e viene avviata una nuova sessione.
• È più adatto a un host gateway personale, non a configurazioni di fatturazione condivise multiutente.

​

Note

• La documentazione pubblica di Anthropic Claude Code continua a documentare l’uso diretto della CLI come claude -p. Riteniamo che il fallback locale gestito dall’utente sia probabilmente consentito, ma la comunicazione separata di Anthropic agli utenti OpenClaw afferma che il percorso Claude-login di OpenClaw è uso di harness di terze parti e richiede Extra Usage (pay-as-you-go fatturato separatamente dall’abbonamento). Per la produzione, consigliamo invece le chiavi API Anthropic.
• Anthropic setup-token è di nuovo disponibile in OpenClaw come percorso legacy/manuale. La comunicazione di fatturazione specifica per OpenClaw di Anthropic si applica ancora, quindi usalo aspettandoti che Anthropic richieda Extra Usage per questo percorso.
• I dettagli di autenticazione e le regole di riuso sono in /concepts/oauth.

​

Risoluzione dei problemi

• L’autenticazione token Anthropic legacy può scadere o essere revocata.
• Per nuove configurazioni, migra a una chiave API Anthropic o al percorso Claude CLI locale sull’host gateway.

• L’autenticazione è per agente. I nuovi agenti non ereditano le chiavi dell’agente principale.
• Riesegui l’onboarding per quell’agente, oppure 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 o Claude CLI per quel percorso di profilo.

• Controlla openclaw models status --json per auth.unusableProfiles.
• I cooldown del rate limit Anthropic possono essere specifici del modello, quindi un modello Anthropic fratello può essere ancora utilizzabile anche quando quello corrente è in cooldown.
• Aggiungi un altro profilo Anthropic o attendi la fine del cooldown.