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.

Vercel AI Gateway fornisce un’API unificata per accedere a centinaia di modelli tramite un unico endpoint.
ProprietàValore
Providervercel-ai-gateway
AutenticazioneAI_GATEWAY_API_KEY
APIcompatibile con Anthropic Messages
Catalogo dei modelliRilevato automaticamente tramite /v1/models
OpenClaw rileva automaticamente il catalogo Gateway /v1/models, quindi /models vercel-ai-gateway include riferimenti di modello correnti come vercel-ai-gateway/openai/gpt-5.5 e vercel-ai-gateway/moonshotai/kimi-k2.6.

​
Per iniziare

1

Imposta la chiave API

Esegui l’onboarding e scegli l’opzione di autenticazione AI Gateway:
openclaw onboard --auth-choice ai-gateway-api-key
2

Imposta un modello predefinito

Aggiungi il modello alla tua configurazione OpenClaw:
{
  agents: {
    defaults: {
      model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
    },
  },
}
3

Verifica che il modello sia disponibile

openclaw models list --provider vercel-ai-gateway

​
Esempio non interattivo

Per configurazioni con script o CI, passa tutti i valori dalla riga di comando: 
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"

​
Abbreviazione dell’ID del modello

OpenClaw accetta riferimenti di modello abbreviati per Vercel Claude e li normalizza in fase di esecuzione:
Input abbreviatoRiferimento di modello normalizzato
vercel-ai-gateway/claude-opus-4.6vercel-ai-gateway/anthropic/claude-opus-4.6
vercel-ai-gateway/opus-4.6vercel-ai-gateway/anthropic/claude-opus-4-6
Puoi usare nella tua configurazione sia l’abbreviazione sia il riferimento di modello completamente qualificato. OpenClaw risolve automaticamente la forma canonica.

​
Configurazione avanzata

Se OpenClaw Gateway viene eseguito come daemon (launchd/systemd), assicurati che AI_GATEWAY_API_KEY sia disponibile per quel processo.
Una chiave impostata solo in ~/.profile non sarà visibile a un daemon launchd/systemd a meno che tale ambiente non venga importato esplicitamente. Imposta la chiave in ~/.openclaw/.env o tramite env.shellEnv per garantire che il processo Gateway possa leggerla.
Vercel AI Gateway instrada le richieste al provider upstream in base al prefisso del riferimento di modello. Ad esempio, vercel-ai-gateway/anthropic/claude-opus-4.6 viene instradato tramite Anthropic, mentre vercel-ai-gateway/openai/gpt-5.5 viene instradato tramite OpenAI e vercel-ai-gateway/moonshotai/kimi-k2.6 viene instradato tramite MoonshotAI. La tua singola chiave AI_GATEWAY_API_KEY gestisce l’autenticazione per tutti i provider upstream.
Le opzioni /think seguono i prefissi dei modelli upstream attendibili quando OpenClaw conosce il contratto del provider upstream. vercel-ai-gateway/anthropic/... usa il profilo di pensiero Claude, inclusi i valori predefiniti adattivi per i modelli Claude 4.6. vercel-ai-gateway/openai/gpt-5.4, gpt-5.5 e i riferimenti in stile Codex espongono /think xhigh proprio come i provider diretti OpenAI/OpenAI Codex. Gli altri riferimenti con namespace mantengono i normali livelli di ragionamento, a meno che i metadati del loro catalogo non ne dichiarino altri.

​
Correlati

Selezione del modello

Scelta dei provider, dei riferimenti di modello e del comportamento di failover.

Risoluzione dei problemi

Risoluzione generale dei problemi e domande frequenti.