--- read_when: - Quieres una sola clave de API para muchos LLMs - Quieres ejecutar modelos mediante OpenRouter en OpenClaw - Quieres usar OpenRouter para generación de imágenes - Quieres usar OpenRouter para generar música - 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-07-03T09:22:54Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: ca36f2a7afd35ea4d276f61ded28524aed7d15715b29eea9aaac0ac6e4abab40 source_path: providers/openrouter.md workflow: 16 --- OpenRouter proporciona una **API unificada** que enruta solicitudes a muchos modelos detrás de un único punto de conexión 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 ```bash openclaw onboard --auth-choice openrouter-oauth ``` OpenClaw abre el flujo de inicio de sesión en el navegador de OpenRouter, intercambia el código PKCE por una clave de API de OpenRouter y almacena esa clave en el perfil de autenticación predeterminado de OpenRouter. En hosts remotos/sin interfaz gráfica, OpenClaw imprime la URL de inicio de sesión y te pide pegar la URL de redirección después de iniciar sesión. La incorporación usa `openrouter/auto` de forma predeterminada. Elige un modelo concreto más adelante: ```bash openclaw models set openrouter// ``` 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 modelo 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 reserva incluidos: | Referencia de modelo | Notas | | --------------------------------- | -------------------------------------- | | `openrouter/auto` | Enrutamiento automático de OpenRouter | | `openrouter/openrouter/fusion` | Enrutador OpenRouter Fusion | | `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 finalizaciones de chat de OpenRouter con `modalities: ["image", "text"]`. Los modelos de imagen de 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, sondea el `polling_url` devuelto y descarga el video completado desde `unsigned_urls` de OpenRouter o desde el punto de conexión documentado de contenido del trabajo. Las imágenes de referencia se envían como imágenes del 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 admitidas actualmente de 4/6/8 segundos, resoluciones `720P`/`1080P` y 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. ## Generación de música OpenRouter también puede respaldar la herramienta `music_generate` mediante la salida de audio de finalizaciones de chat. Usa un modelo de audio de OpenRouter en `agents.defaults.musicGenerationModel`: ```json5 { env: { OPENROUTER_API_KEY: "sk-or-..." }, agents: { defaults: { musicGenerationModel: { primary: "openrouter/google/lyria-3-pro-preview", timeoutMs: 180_000, }, }, }, } ``` El proveedor de música de OpenRouter incluido usa de forma predeterminada `google/lyria-3-pro-preview` y también expone `google/lyria-3-clip-preview`. OpenClaw envía `modalities: ["text", "audio"]`, habilita la transmisión, recopila los fragmentos de audio transmitidos y guarda el resultado como medios generados para la entrega por canal. Se aceptan imágenes de referencia para modelos Lyria mediante el parámetro compartido `music_generate image=...`. ## Texto a voz OpenRouter también puede usarse como proveedor de TTS mediante su punto de conexión `/audio/speech` compatible con OpenAI. ```json5 { messages: { tts: { auto: "always", provider: "openrouter", providers: { openrouter: { model: "hexgrad/kokoro-82m", speakerVoice: "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 punto de conexión STT (`/audio/transcriptions`). Esto se aplica a cualquier Plugin de canal que reenvíe voz/audio entrante a la comprobación previa de comprensión de medios. ```json5 { tools: { media: { audio: { enabled: true, models: [{ provider: "openrouter", model: "openai/whisper-large-v3-turbo" }], }, }, }, } ``` OpenClaw envía 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. ## Enrutador Fusion Usa OpenRouter Fusion cuando quieras que una referencia de modelo de OpenClaw pregunte a varios modelos de OpenRouter en paralelo, que OpenRouter evalúe sus respuestas y devuelva una única respuesta final mediante el punto de conexión normal del proveedor OpenRouter. Como el slug del modelo upstream es `openrouter/fusion`, la referencia de modelo de OpenClaw incluye tanto el prefijo del proveedor de OpenClaw como el espacio de nombres upstream de OpenRouter: ```bash openclaw models set openrouter/openrouter/fusion ``` Configura el panel y el juez de Fusion mediante `params.extraBody` del modelo. Esos campos se reenvían al cuerpo de la solicitud de finalizaciones de chat de OpenRouter. Fusion funciona con la incorporación OAuth de OpenRouter o con la incorporación con clave de API; si usas OAuth, omite la línea `env.OPENROUTER_API_KEY` del ejemplo siguiente. ```json5 { env: { OPENROUTER_API_KEY: "sk-or-..." }, agents: { defaults: { model: { primary: "openrouter/openrouter/fusion" }, models: { "openrouter/openrouter/fusion": { params: { extraBody: { plugins: [ { id: "fusion", analysis_models: [ "google/gemini-3.5-flash", "moonshotai/kimi-k2.6", "deepseek/deepseek-v4-pro", ], model: "google/gemini-3.5-flash", }, ], }, }, }, }, }, }, } ``` La lista `analysis_models` es el panel paralelo, y `model` dentro de la configuración del Plugin Fusion es el modelo juez. No establezcas `tool_choice` de nivel superior en `"required"` en turnos normales de agente/chat de OpenClaw para intentar forzar Fusion; los turnos de OpenClaw pueden incluir definiciones de herramientas de OpenClaw, y una elección de herramienta requerida de nivel superior puede exigir una de esas herramientas en lugar del enrutador Fusion. Cuando esta configuración del Plugin Fusion está presente, OpenClaw también añade una nota saneada al prompt del sistema con los modelos de análisis configurados y el modelo juez para que el agente pueda responder preguntas sobre su panel Fusion actual. Otros campos de `extraBody` no se copian al prompt. Fusion es más lento por diseño. OpenRouter puede enviar el mismo prompt de OpenClaw a varios modelos de análisis y luego ejecutar un paso final de juicio/síntesis, por lo que la latencia suele ser mayor que en una solicitud directa de un solo modelo. Usa Fusion para respuestas deliberadas y de alta calidad o rutas de escalado, no como opción predeterminada para chat sensible a la latencia. Para obtener respuestas más rápidas, mantén el panel pequeño y elige modelos de análisis y juez más rápidos. Prueba la referencia configurada con una llamada local de modelo de una sola ejecución: ```bash openclaw infer model run --local \ --model openrouter/openrouter/fusion \ --prompt "Reply with exactly: FUSION_OK" \ --json ``` ## Autenticación y encabezados OpenRouter usa internamente un token Bearer con tu clave de API. OpenRouter OAuth es un flujo de inicio de sesión PKCE que emite una clave de API de OpenRouter, por lo que OpenClaw almacena el resultado como el mismo perfil de autenticación con clave de API `openrouter:default` usado por la ruta de configuración manual con clave de API. Para una instalación existente, inicia sesión o rota la clave de OpenRouter almacenada sin volver a ejecutar toda la incorporación: ```bash openclaw models auth login --provider openrouter --method oauth ``` Usa `openclaw models auth login --provider openrouter --method api-key` cuando quieras pegar una clave que creaste manualmente en OpenRouter. En solicitudes reales a OpenRouter (`https://openrouter.ai/api/v1`), OpenClaw también añade 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 algún 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. Habilítala 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 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 Anthropic `cache_control` de OpenRouter. Solo se aplica en rutas verificadas de `openrouter.ai`, no en URL base de proxy personalizadas. En rutas verificadas de OpenRouter, las referencias de modelos Anthropic conservan los marcadores Anthropic `cache_control` específicos de OpenRouter que OpenClaw usa para reutilizar mejor la caché de prompts en bloques de prompt del sistema/desarrollador. En rutas verificadas de OpenRouter, las referencias de modelos de Anthropic con razonamiento habilitado descartan los turnos finales de prefill del asistente antes de que la solicitud llegue a OpenRouter, coincidiendo con el requisito de Anthropic de que las conversaciones de razonamiento terminen con un turno de usuario. En rutas compatibles que no sean `auto`, OpenClaw asigna el nivel de pensamiento seleccionado a las cargas útiles 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 del proxy para referencias de modelos 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 el `reasoning_content` faltante en turnos de asistente repetidos para que las conversaciones de pensamiento/herramientas mantengan la forma de seguimiento requerida por DeepSeek V4. OpenClaw envía valores de `reasoning.effort` compatibles con OpenRouter para estas rutas; los niveles inferiores que no sean off se asignan a `high`, y las anulaciones obsoletas de `max` se asignan a `xhigh`. OpenRouter sigue pasando por la ruta compatible con OpenAI de estilo proxy, por lo que el modelado de solicitudes nativo exclusivo de OpenAI, como `serviceTier`, Responses `store`, cargas útiles de compatibilidad de razonamiento de OpenAI y sugerencias de caché de prompts, no se reenvía. Las referencias de OpenRouter respaldadas por Gemini permanecen en la ruta proxy-Gemini: OpenClaw mantiene allí la depuración de firmas de pensamiento de Gemini, pero no habilita la validación de repetición nativa de Gemini ni las reescrituras de arranque. OpenRouter admite un objeto de solicitud `provider` para el enrutamiento del proveedor subyacente. Configura una política predeterminada para todas las solicitudes de modelos de texto de OpenRouter con `models.providers.openrouter.params.provider`: ```json5 { models: { providers: { openrouter: { params: { provider: { sort: "latency", require_parameters: true, data_collection: "deny", }, }, }, }, }, } ``` OpenClaw reenvía ese objeto a OpenRouter como la carga útil `provider` de la solicitud. Usa los campos snake_case documentados de OpenRouter, incluidos `sort`, `only`, `ignore`, `order`, `allow_fallbacks`, `require_parameters`, `data_collection`, `quantizations`, `max_price`, `preferred_max_latency`, `preferred_min_throughput`, `zdr` y `enforce_distillable_text`. Los parámetros por modelo siguen anulando el objeto de enrutamiento de todo el proveedor: ```json5 { agents: { defaults: { models: { "openrouter/anthropic/claude-sonnet-4-6": { params: { provider: { order: ["anthropic"], allow_fallbacks: false, }, }, }, }, }, }, } ``` Esto solo se aplica en rutas de completions de chat de OpenRouter. Las rutas directas de Anthropic, Google, OpenAI o proveedores personalizados ignoran los parámetros de enrutamiento de OpenRouter. ## Relacionado Elegir proveedores, referencias de modelos y comportamiento de conmutación por error. Referencia completa de configuración para agentes, modelos y proveedores.