Skip to main content
Il Vercel AI Gateway fornisce un’API unificata per accedere a centinaia di modelli tramite un singolo endpoint.
OpenClaw rileva automaticamente il catalogo /v1/models del Gateway, quindi sia il comando di chat /models vercel-ai-gateway sia openclaw models list --provider vercel-ai-gateway includono i riferimenti ai modelli correnti, come vercel-ai-gateway/openai/gpt-5.5 e vercel-ai-gateway/moonshotai/kimi-k2.6.

Guida introduttiva

1

Installa il plugin

2

Imposta la chiave API

3

Imposta un modello predefinito

4

Verifica che il modello sia disponibile

Esempio non interattivo

Forma abbreviata dell’ID del modello

OpenClaw normalizza in fase di esecuzione i riferimenti abbreviati ai modelli Claude:
Puoi utilizzare entrambe le forme nella configurazione; OpenClaw risolve automaticamente il riferimento canonico anthropic/....

Configurazione avanzata

Se il Gateway di OpenClaw viene eseguito come daemon (launchd/systemd), assicurati che AI_GATEWAY_API_KEY sia disponibile per tale processo.
Una chiave esportata solo in una shell interattiva non sarà visibile a un daemon launchd/systemd, a meno che l’ambiente non venga importato esplicitamente. Imposta la chiave in ~/.openclaw/.env o tramite env.shellEnv per assicurarti che il processo del Gateway possa leggerla.
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.
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.