Saltar al contenido principal
El Vercel AI Gateway proporciona una API unificada para acceder a cientos de modelos a través de un único endpoint.
PropiedadValor
Proveedorvercel-ai-gateway
Paquete@openclaw/vercel-ai-gateway-provider
AutenticaciónAI_GATEWAY_API_KEY
APICompatible con Anthropic Messages
URL basehttps://ai-gateway.vercel.sh
Catálogo de modelosDescubierto automáticamente mediante /v1/models
OpenClaw descubre automáticamente el catálogo /v1/models del Gateway, por lo que tanto el comando de chat /models vercel-ai-gateway como openclaw models list --provider vercel-ai-gateway incluyen refs de modelos actuales como vercel-ai-gateway/openai/gpt-5.5 y vercel-ai-gateway/moonshotai/kimi-k2.6.

​
Primeros pasos

1

Instala el plugin

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

Configura la clave de API

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

Configura un modelo predeterminado

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

Verifica que el modelo esté disponible

openclaw models list --provider vercel-ai-gateway

​
Ejemplo no interactivo

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

​
Forma abreviada del ID de modelo

OpenClaw normaliza las refs de modelo abreviadas de Claude en tiempo de ejecución:
Entrada abreviadaRef 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
Usa cualquiera de las dos formas en tu configuración; OpenClaw resuelve automáticamente la ref canónica anthropic/....

​
Configuración avanzada

Si el OpenClaw Gateway se ejecuta como daemon (launchd/systemd), asegúrate de que AI_GATEWAY_API_KEY esté disponible para ese proceso.
Una clave exportada solo en una shell interactiva no será visible para un daemon launchd/systemd a menos que ese entorno se importe explícitamente. Configura la clave en ~/.openclaw/.env o mediante env.shellEnv para garantizar que el proceso del gateway pueda leerla.
Vercel AI Gateway enruta cada solicitud al proveedor upstream nombrado en el prefijo de la ref de modelo. Por ejemplo, vercel-ai-gateway/anthropic/claude-opus-4.6 se enruta a través de Anthropic, vercel-ai-gateway/openai/gpt-5.5 se enruta a través de OpenAI, y vercel-ai-gateway/moonshotai/kimi-k2.6 se enruta a través de MoonshotAI. Una única AI_GATEWAY_API_KEY autentica todos los proveedores upstream.
Las opciones de /think siguen el prefijo del modelo upstream cuando OpenClaw lo reconoce. vercel-ai-gateway/anthropic/... usa el perfil de pensamiento de Claude, incluido el valor predeterminado adaptativo para los modelos Claude 4.6. Las refs de confianza vercel-ai-gateway/openai/... (gpt-5.2 y posteriores, además de las variantes de Codex hasta gpt-5.1-codex) exponen /think xhigh. Otras refs con espacio de nombres conservan los niveles de razonamiento estándar a menos que los metadatos de su catálogo declaren más.

​
Relacionado

Selección de modelos

Elegir proveedores, refs de modelo y comportamiento de conmutación por error.

Solución de problemas

Solución general de problemas y preguntas frecuentes.