Cómo usar Vercel AI Gateway para gestionar tus modelos

Seguro que te ha pasado: quieres probar un modelo nuevo pero tienes que configurar otra API key, cambiar la URL del endpoint y rezar para que el formato sea compatible. Es una pérdida de tiempo total cuando solo quieres que el código funcione y ver resultados rápido.

Vercel AI Gateway resuelve esto de un plumazo. Te da una única puerta de entrada para usar Anthropic, OpenAI o cualquier otro proveedor sin complicarte la vida. Yo lo uso para centralizar todo y dejar de pelearme con archivos de configuración infinitos.

Requisitos previos

• Una API key de Vercel AI Gateway activa.
• OpenClaw instalado en tu entorno local.

Inicio rápido

Configura el acceso en menos de 5 minutos siguiendo estos pasos. Es la ruta más corta para tener todo listo.

1. Configura tu API key (te recomiendo guardarla específicamente para el Gateway):

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

2. Define el modelo por defecto en tu archivo de configuración:

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

Si prefieres una configuración automatizada sin interactuar con la terminal, usa este comando:

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

Solución de problemas

Si algo no funciona como esperas, revisa estos puntos:

• Variables de entorno invisibles: Si usas el Gateway como un daemon (con launchd o systemd), el proceso podría no ver tu AI_GATEWAY_API_KEY. Asegúrate de incluirla en ~/.openclaw/.env o cargarla mediante env.shellEnv.
• Errores de autenticación: Verifica que el provider esté escrito exactamente como vercel-ai-gateway. Un error tipográfico aquí hará que la petición falle antes de salir de tu máquina.

Próximos pasos

• Configuración avanzada de agentes
• Guía de modelos compatibles

¿Tienes dudas con la configuración? Pregunta a nuestro AI Setup Assistant.