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

Providers

Gateway de IA de Vercel

Vercel AI Gateway proporciona una API unificada para acceder a cientos de modelos mediante un único endpoint.

Propiedad Valor
Proveedor vercel-ai-gateway
Paquete @openclaw/vercel-ai-gateway-provider
Autenticación AI_GATEWAY_API_KEY
API Compatible con Anthropic Messages
URL base https://ai-gateway.vercel.sh
Catálogo de modelos Detectado automáticamente mediante /v1/models

Primeros pasos

  • Instalar el plugin

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

  • Configurar la clave de API

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

  • Configurar un modelo predeterminado

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

  • Verificar que el modelo esté disponible

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

    • Ejemplo no interactivo

    bash
    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 en tiempo de ejecución las referencias abreviadas de modelos Claude:

    Entrada abreviada Referencia de modelo normalizada
    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

    Configuración avanzada

    Variable de entorno para procesos daemon

    Si el Gateway de OpenClaw se ejecuta como daemon (launchd/systemd), hay que asegurarse de que AI_GATEWAY_API_KEY esté disponible para ese proceso.

    Enrutamiento de proveedores

    Vercel AI Gateway dirige cada solicitud al proveedor ascendente indicado en el prefijo de la referencia del modelo. Por ejemplo, vercel-ai-gateway/anthropic/claude-opus-4.6 se dirige a través de Anthropic, vercel-ai-gateway/openai/gpt-5.5 se dirige a través de OpenAI y vercel-ai-gateway/moonshotai/kimi-k2.6 se dirige a través de MoonshotAI. Un único AI_GATEWAY_API_KEY autentica a todos los proveedores ascendentes.

    Niveles de pensamiento

    Las opciones de /think siguen el prefijo del modelo ascendente cuando OpenClaw lo reconoce. vercel-ai-gateway/anthropic/... utiliza el perfil de pensamiento de Claude, incluido el valor predeterminado adaptativo para los modelos Claude 4.6. Las referencias 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 referencias con espacio de nombres mantienen los niveles de razonamiento estándar, a menos que los metadatos de su catálogo declaren niveles adicionales.

    Contenido relacionado

    Selección de modelos

    Cómo elegir proveedores, referencias de modelos y el comportamiento de conmutación por error.
    Solución de problemas

    Solución general de problemas y preguntas frecuentes.
    Was this useful?
    On this page

    On this page