Saltar al contenido principal

​
Vercel AI Gateway

Vercel AI Gateway proporciona una API unificada para acceder a cientos de modelos a través de un único endpoint.
PropertyValue
Proveedorvercel-ai-gateway
AutenticaciónAI_GATEWAY_API_KEY
APICompatible con Anthropic Messages
Catálogo de modelosDescubierto automáticamente mediante /v1/models
OpenClaw descubre automáticamente el catálogo /v1/models de Gateway, por lo que /models vercel-ai-gateway incluye referencias de modelo actuales como vercel-ai-gateway/openai/gpt-5.4.

​
Primeros pasos

1

Establecer la clave de API

Ejecuta onboarding y elige la opción de autenticación de AI Gateway:
openclaw onboard --auth-choice ai-gateway-api-key
2

Establecer un modelo predeterminado

Agrega el modelo a tu configuración de OpenClaw:
{
  agents: {
    defaults: {
      model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
    },
  },
}
3

Verificar que el modelo esté disponible

openclaw models list --provider vercel-ai-gateway

​
Ejemplo no interactivo

Para configuraciones con scripts o CI, pasa todos los valores en la línea de comandos: 
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"

​
Forma abreviada de ID de modelo

OpenClaw acepta referencias abreviadas de modelos Claude de Vercel y las normaliza en tiempo de ejecución:
Entrada abreviadaReferencia de modelo normalizada
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
Puedes usar la forma abreviada o la referencia de modelo completamente calificada en tu configuración. OpenClaw resuelve automáticamente la forma canónica.

​
Notas avanzadas

Si el Gateway de OpenClaw se ejecuta como daemon (launchd/systemd), asegúrate de que AI_GATEWAY_API_KEY esté disponible para ese proceso.
Una clave establecida solo en ~/.profile no será visible para un daemon launchd/systemd a menos que ese entorno se importe explícitamente. Establece la clave en ~/.openclaw/.env o mediante env.shellEnv para garantizar que el proceso de Gateway pueda leerla.
Vercel AI Gateway enruta las solicitudes al proveedor ascendente en función del prefijo de la referencia del modelo. Por ejemplo, vercel-ai-gateway/anthropic/claude-opus-4.6 se enruta mediante Anthropic, mientras que vercel-ai-gateway/openai/gpt-5.4 se enruta mediante OpenAI. Tu único AI_GATEWAY_API_KEY gestiona la autenticación para todos los proveedores ascendentes.

​
Relacionado

Selección de modelo

Elegir proveedores, referencias de modelos y comportamiento de failover.

Solución de problemas

Solución general de problemas y preguntas frecuentes.