OpenClawDocs
In questa pagina

In questa pagina

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Gateway AI di Vercel

Il Vercel AI Gateway fornisce un'API unificata per accedere a centinaia di modelli tramite un singolo endpoint.

Proprietà Valore
Provider vercel-ai-gateway
Pacchetto @openclaw/vercel-ai-gateway-provider
Autenticazione AI_GATEWAY_API_KEY
API Compatibile con Anthropic Messages
URL di base https://ai-gateway.vercel.sh
Catalogo dei modelli Rilevato automaticamente tramite /v1/models

Guida introduttiva

  • Installa il plugin

    bash
    openclaw plugins install @openclaw/vercel-ai-gateway-provider

  • Imposta la chiave API

    bash
    openclaw onboard --auth-choice ai-gateway-api-key

  • Imposta un modello predefinito

    json5
    {  agents: {    defaults: {      model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },    },  },}

  • Verifica che il modello sia disponibile

    bash
    openclaw models list --provider vercel-ai-gateway

    • Esempio non interattivo

    bash
    openclaw onboard --non-interactive \  --mode local \  --auth-choice ai-gateway-api-key \  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"

    Forma abbreviata dell'ID del modello

    OpenClaw normalizza in fase di esecuzione i riferimenti abbreviati ai modelli Claude:

    Input abbreviato Riferimento normalizzato al modello
    vercel-ai-gateway/claude-opus-4.6 vercel-ai-gateway/anthropic/claude-opus-4.6
    vercel-ai-gateway/opus-4.6 vercel-ai-gateway/anthropic/claude-opus-4-6

    Configurazione avanzata

    Variabile di ambiente per i processi daemon

    Se il Gateway di OpenClaw viene eseguito come daemon (launchd/systemd), assicurati che AI_GATEWAY_API_KEY sia disponibile per tale processo.

    Instradamento del provider

    Vercel AI Gateway instrada ogni richiesta al provider upstream indicato nel prefisso del riferimento al modello. Ad esempio, vercel-ai-gateway/anthropic/claude-opus-4.6 viene instradato tramite Anthropic, vercel-ai-gateway/openai/gpt-5.5 tramite OpenAI e vercel-ai-gateway/moonshotai/kimi-k2.6 tramite MoonshotAI. Una singola AI_GATEWAY_API_KEY autentica tutti i provider upstream.

    Livelli di ragionamento

    Le opzioni di /think seguono il prefisso del modello upstream quando OpenClaw lo riconosce. vercel-ai-gateway/anthropic/... utilizza il profilo di ragionamento di Claude, incluso il valore predefinito adattivo per i modelli Claude 4.6. I riferimenti attendibili vercel-ai-gateway/openai/... (gpt-5.2 e versioni successive, oltre alle varianti Codex fino a gpt-5.1-codex) espongono /think xhigh. Gli altri riferimenti con spazio dei nomi mantengono i livelli di ragionamento standard, a meno che i metadati del catalogo non ne dichiarino altri.

    Contenuti correlati

    Selezione del modello

    Scelta dei provider, dei riferimenti ai modelli e del comportamento di failover.
    Risoluzione dei problemi

    Risoluzione generale dei problemi e domande frequenti.
    Was this useful?