---
read_when:
- Desea una sola clave de API para muchos LLMs
- Quieres ejecutar modelos mediante OpenRouter en OpenClaw
- Quieres usar OpenRouter para generar imágenes
- Quieres usar OpenRouter para la generación de video
summary: Usa la API unificada de OpenRouter para acceder a muchos modelos en OpenClaw
title: OpenRouter
x-i18n:
generated_at: "2026-05-12T08:45:50Z"
model: gpt-5.5
provider: openai
source_hash: 0dbf2b5a69636eb18471dd7d1dcf05ee30da931e2e3b5c9ae5d44a20d3e46f78
source_path: providers/openrouter.md
workflow: 16
---
OpenRouter proporciona una **API unificada** que enruta solicitudes a muchos modelos detrás de un único
endpoint y clave de API. Es compatible con OpenAI, por lo que la mayoría de los SDK de OpenAI funcionan cambiando la URL base.
## Primeros pasos
Crea una clave de API en [openrouter.ai/keys](https://openrouter.ai/keys).
```bash
openclaw onboard --auth-choice openrouter-api-key
```
La incorporación usa `openrouter/auto` de forma predeterminada. Elige un modelo concreto más adelante:
```bash
openclaw models set openrouter//
```
## Ejemplo de configuración
```json5
{
env: { OPENROUTER_API_KEY: "sk-or-..." },
agents: {
defaults: {
model: { primary: "openrouter/auto" },
},
},
}
```
## Referencias de modelos
Las referencias de modelo siguen el patrón `openrouter//`. Para ver la lista completa de
proveedores y modelos disponibles, consulta [/concepts/model-providers](/es/concepts/model-providers).
Ejemplos de respaldo incluidos:
| Referencia de modelo | Notas |
| --------------------------------- | -------------------------------------- |
| `openrouter/auto` | Enrutamiento automático de OpenRouter |
| `openrouter/moonshotai/kimi-k2.6` | Kimi K2.6 mediante MoonshotAI |
| `openrouter/moonshotai/kimi-k2.5` | Kimi K2.5 mediante MoonshotAI |
## Generación de imágenes
OpenRouter también puede respaldar la herramienta `image_generate`. Usa un modelo de imagen de OpenRouter en `agents.defaults.imageGenerationModel`:
```json5
{
env: { OPENROUTER_API_KEY: "sk-or-..." },
agents: {
defaults: {
imageGenerationModel: {
primary: "openrouter/google/gemini-3.1-flash-image-preview",
timeoutMs: 180_000,
},
},
},
}
```
OpenClaw envía solicitudes de imagen a la API de imágenes de completions de chat de OpenRouter con `modalities: ["image", "text"]`. Los modelos de imagen Gemini reciben sugerencias compatibles de `aspectRatio` y `resolution` mediante `image_config` de OpenRouter. Usa `agents.defaults.imageGenerationModel.timeoutMs` para modelos de imagen de OpenRouter más lentos; el parámetro `timeoutMs` por llamada de la herramienta `image_generate` sigue teniendo prioridad.
## Generación de video
OpenRouter también puede respaldar la herramienta `video_generate` mediante su API asíncrona `/videos`. Usa un modelo de video de OpenRouter en `agents.defaults.videoGenerationModel`:
```json5
{
env: { OPENROUTER_API_KEY: "sk-or-..." },
agents: {
defaults: {
videoGenerationModel: {
primary: "openrouter/google/veo-3.1-fast",
},
},
},
}
```
OpenClaw envía trabajos de texto a video y de imagen a video a OpenRouter, consulta
la `polling_url` devuelta y descarga el video completado desde
los `unsigned_urls` de OpenRouter o el endpoint documentado de contenido del trabajo.
Las imágenes de referencia se envían como imágenes de primer/último fotograma de forma predeterminada; las imágenes
etiquetadas con `reference_image` se envían como referencias de entrada de OpenRouter. El valor predeterminado
incluido `google/veo-3.1-fast` anuncia las duraciones actualmente compatibles de 4/6/8
segundos, las resoluciones `720P`/`1080P` y las relaciones de aspecto `16:9`/`9:16`.
Video a video no está registrado para OpenRouter porque la API upstream de
generación de video actualmente acepta referencias de texto e imagen.
## Texto a voz
OpenRouter también puede usarse como proveedor TTS mediante su endpoint compatible con OpenAI
`/audio/speech`.
```json5
{
messages: {
tts: {
auto: "always",
provider: "openrouter",
providers: {
openrouter: {
model: "hexgrad/kokoro-82m",
voice: "af_alloy",
responseFormat: "mp3",
},
},
},
},
}
```
Si se omite `messages.tts.providers.openrouter.apiKey`, TTS reutiliza
`models.providers.openrouter.apiKey` y luego `OPENROUTER_API_KEY`.
## Voz a texto (audio entrante)
OpenRouter puede transcribir adjuntos entrantes de voz/audio mediante la ruta compartida
`tools.media.audio` usando su endpoint STT (`/audio/transcriptions`).
Esto se aplica a cualquier Plugin de canal que reenvíe voz/audio entrante a
la verificación previa de comprensión multimedia.
```json5
{
tools: {
media: {
audio: {
enabled: true,
models: [{ provider: "openrouter", model: "openai/whisper-large-v3-turbo" }],
},
},
},
}
```
OpenClaw envía las solicitudes STT de OpenRouter como JSON con audio en base64 en
`input_audio` (contrato STT de OpenRouter), no como cargas de formulario multipart de OpenAI.
## Autenticación y encabezados
OpenRouter usa internamente un token Bearer con tu clave de API.
En solicitudes reales de OpenRouter (`https://openrouter.ai/api/v1`), OpenClaw también agrega
los encabezados documentados de atribución de aplicación de OpenRouter:
| Encabezado | Valor |
| ------------------------- | ------------------------------------------------------------------------------------------------------ |
| `HTTP-Referer` | `https://openclaw.ai` |
| `X-OpenRouter-Title` | `OpenClaw` |
| `X-OpenRouter-Categories` | `cli-agent,cloud-agent,programming-app,creative-writing,writing-assistant,general-chat,personal-agent` |
Si rediriges el proveedor OpenRouter a otro proxy o URL base, OpenClaw
**no** inyecta esos encabezados específicos de OpenRouter ni marcadores de caché de Anthropic.
## Configuración avanzada
La caché de respuestas de OpenRouter es opcional. Actívala por modelo de OpenRouter con
parámetros de modelo:
```json5
{
agents: {
defaults: {
models: {
"openrouter/auto": {
params: {
responseCache: true,
responseCacheTtlSeconds: 300,
},
},
},
},
},
}
```
OpenClaw envía `X-OpenRouter-Cache: true` y, cuando está configurado,
`X-OpenRouter-Cache-TTL`. `responseCacheClear: true` fuerza una actualización para
la solicitud actual y almacena la respuesta de reemplazo. También se aceptan alias en snake_case
(`response_cache`, `response_cache_ttl_seconds` y
`response_cache_clear`).
Esto es independiente de la caché de prompts del proveedor y de los marcadores
`cache_control` de Anthropic de OpenRouter. Solo se aplica en rutas
`openrouter.ai` verificadas, no en URLs base de proxy personalizadas.
En rutas verificadas de OpenRouter, las referencias de modelos Anthropic conservan los
marcadores `cache_control` específicos de Anthropic de OpenRouter que OpenClaw usa para
mejorar la reutilización de la caché de prompts en bloques de prompts de sistema/desarrollador.
En rutas verificadas de OpenRouter, las referencias de modelos Anthropic con razonamiento activado
eliminan los turnos finales de precarga del assistant antes de que la solicitud llegue a OpenRouter,
cumpliendo el requisito de Anthropic de que las conversaciones con razonamiento terminen con un turno
de usuario.
En rutas no `auto` compatibles, OpenClaw asigna el nivel de pensamiento seleccionado a
payloads de razonamiento del proxy de OpenRouter. Las sugerencias de modelos no compatibles y
`openrouter/auto` omiten esa inyección de razonamiento. Hunter Alpha también omite
el razonamiento de proxy para referencias de modelo configuradas obsoletas porque OpenRouter podría
devolver texto de respuesta final en campos de razonamiento para esa ruta retirada.
En rutas verificadas de OpenRouter, `openrouter/deepseek/deepseek-v4-flash` y
`openrouter/deepseek/deepseek-v4-pro` completan `reasoning_content` faltante en
turnos de assistant reproducidos para que las conversaciones de pensamiento/herramientas mantengan la
forma de seguimiento requerida por DeepSeek V4. OpenClaw envía valores
`reasoning_effort` compatibles con OpenRouter para estas rutas; `xhigh` es el nivel anunciado
más alto, y las sobrescrituras obsoletas de `max` se asignan a `xhigh`.
OpenRouter sigue pasando por la ruta compatible con OpenAI de estilo proxy, por lo que
no se reenvía el modelado de solicitudes nativo solo de OpenAI, como `serviceTier`, `store` de Responses,
payloads de compatibilidad de razonamiento de OpenAI y sugerencias de caché de prompts.
Las referencias de OpenRouter respaldadas por Gemini permanecen en la ruta proxy-Gemini: OpenClaw mantiene
allí el saneamiento de firmas de pensamiento de Gemini, pero no activa la validación de reproducción
nativa de Gemini ni reescrituras de arranque.
Si pasas enrutamiento de proveedor de OpenRouter en los parámetros del modelo, OpenClaw lo reenvía
como metadatos de enrutamiento de OpenRouter antes de que se ejecuten los contenedores de streaming compartidos.
## Relacionado
Elección de proveedores, referencias de modelo y comportamiento de conmutación por error.
Referencia completa de configuración para agentes, modelos y proveedores.