---
read_when:
    - Quieres usar Vercel AI Gateway con OpenClaw
    - Necesitas la variable de entorno de clave de API o la opción de autenticación de la CLI
summary: Configuración de Vercel AI Gateway (autenticación + selección de modelo)
title: Gateway de Vercel AI
x-i18n:
    generated_at: "2026-06-27T12:45:59Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 27aeeeff28661839f3be55c60bf1b383b95af78e17abb77441ae4e81f58688ed
    source_path: providers/vercel-ai-gateway.md
    workflow: 16
---

El [Vercel AI Gateway](https://vercel.com/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` |
| Auth          | `AI_GATEWAY_API_KEY`                   |
| API           | compatible con Anthropic Messages      |
| Catálogo de modelos | descubierto automáticamente mediante `/v1/models` |

<Tip>
OpenClaw descubre automáticamente el catálogo `/v1/models` del Gateway, por lo que
`/models vercel-ai-gateway` incluye referencias de modelos actuales como
`vercel-ai-gateway/openai/gpt-5.5` y
`vercel-ai-gateway/moonshotai/kimi-k2.6`.
</Tip>

## Primeros pasos

<Steps>
  <Step title="Instalar el plugin">
    ```bash
    openclaw plugins install @openclaw/vercel-ai-gateway-provider
    ```
  </Step>
  <Step title="Configurar la clave de API">
    Ejecuta la incorporación y elige la opción de autenticación de AI Gateway:

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

  </Step>
  <Step title="Configurar un modelo predeterminado">
    Añade el modelo a tu configuración de OpenClaw:

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

  </Step>
  <Step title="Verificar que el modelo está disponible">
    ```bash
    openclaw models list --provider vercel-ai-gateway
    ```
  </Step>
</Steps>

## Ejemplo no interactivo

Para configuraciones con scripts o de CI, pasa todos los valores en la línea de comandos:

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

## Abreviatura de ID de modelo

OpenClaw acepta referencias abreviadas de modelos Claude de Vercel y las normaliza en
tiempo de ejecución:

| 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` |

<Tip>
Puedes usar la abreviatura o la referencia de modelo completa en tu
configuración. OpenClaw resuelve la forma canónica automáticamente.
</Tip>

## Configuración avanzada

<AccordionGroup>
  <Accordion title="Variable de entorno para procesos daemon">
    Si el Gateway de OpenClaw se ejecuta como daemon (launchd/systemd), asegúrate de que
    `AI_GATEWAY_API_KEY` esté disponible para ese proceso.

    <Warning>
    Una clave exportada solo en un shell interactivo 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.
    </Warning>

  </Accordion>

  <Accordion title="Enrutamiento de proveedores">
    Vercel AI Gateway enruta las solicitudes al proveedor ascendente según el prefijo de
    la referencia del modelo. Por ejemplo, `vercel-ai-gateway/anthropic/claude-opus-4.6` se enruta
    a través de Anthropic, mientras que `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. Tu única `AI_GATEWAY_API_KEY` gestiona la autenticación para todos
    los proveedores ascendentes.
  </Accordion>
  <Accordion title="Niveles de razonamiento">
    Las opciones de `/think` siguen prefijos de modelos ascendentes de confianza cuando OpenClaw conoce
    el contrato del proveedor ascendente. `vercel-ai-gateway/anthropic/...` usa el
    perfil de razonamiento de Claude, incluidos los valores predeterminados adaptativos para modelos Claude 4.6.
    `vercel-ai-gateway/openai/gpt-5.4`, `gpt-5.5` y las referencias de estilo Codex exponen
    `/think xhigh` igual que los proveedores directos OpenAI/OpenAI Codex. Otras
    referencias con espacio de nombres mantienen los niveles normales de razonamiento a menos que sus metadatos de catálogo
    declaren más.
  </Accordion>
</AccordionGroup>

## Relacionado

<CardGroup cols={2}>
  <Card title="Selección de modelos" href="/es/concepts/model-providers" icon="layers">
    Elegir proveedores, referencias de modelos y comportamiento de conmutación por error.
  </Card>
  <Card title="Solución de problemas" href="/es/help/troubleshooting" icon="wrench">
    Solución general de problemas y preguntas frecuentes.
  </Card>
</CardGroup>