--- read_when: - Quieres una única clave de API para muchos LLM. - Quieres ejecutar modelos mediante OpenRouter en OpenClaw - Quieres usar OpenRouter para generar imágenes - Quieres usar OpenRouter para generar música - Quieres usar OpenRouter para generar videos summary: Usa la API unificada de OpenRouter para acceder a numerosos modelos en OpenClaw title: OpenRouter x-i18n: generated_at: "2026-07-11T23:27:20Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: 3047a4da1727db1463d77fcc566231b528e2c34cc64eccaa36827e2927cc60a7 source_path: providers/openrouter.md workflow: 16 --- OpenRouter enruta solicitudes a muchos modelos tras una sola API y una sola clave. Es compatible con OpenAI, por lo que OpenClaw se comunica con él mediante el mismo transporte de estilo `openai-completions` que se utiliza para otros proveedores proxy. ## Primeros pasos ```bash openclaw onboard --auth-choice openrouter-oauth ``` OpenClaw abre el flujo de inicio de sesión de OpenRouter en el navegador (PKCE), intercambia el código por una clave de API de OpenRouter y la almacena en el perfil de autenticación predeterminado de OpenRouter. En hosts remotos o sin interfaz gráfica, OpenClaw muestra la URL de inicio de sesión y solicita que pegues la URL de redirección después de iniciar sesión. La incorporación usa `openrouter/auto` de forma predeterminada. Elige más adelante un modelo concreto: ```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 más adelante un modelo concreto: ```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 modelos siguen el patrón `openrouter//`. Para consultar la lista completa de proveedores y modelos disponibles, consulta [/concepts/model-providers](/es/concepts/model-providers). Modelos alternativos incluidos, utilizados cuando no está disponible la detección del catálogo en vivo: | Referencia del 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 | Cualquier otra referencia `openrouter//`, incluida `openrouter/openrouter/fusion` (consulta [Enrutador Fusion](#fusion-router)), se resuelve dinámicamente mediante el catálogo de modelos en vivo de OpenRouter. ## Generación de imágenes OpenRouter puede respaldar la herramienta `image_generate`. Configura un modelo de imágenes 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 las solicitudes de imágenes a la API de imágenes de finalizaciones de chat de OpenRouter con `modalities: ["image", "text"]`. Además, los modelos de imágenes Gemini reciben indicaciones de `aspectRatio` y `resolution` mediante `image_config` de OpenRouter; los demás modelos de imágenes no. Usa `agents.defaults.imageGenerationModel.timeoutMs` para modelos más lentos; el valor `timeoutMs` por llamada de la herramienta `image_generate` sigue teniendo prioridad. ## Generación de vídeo OpenRouter puede respaldar la herramienta `video_generate` mediante su API asíncrona `/videos`. Configura un modelo de vídeo 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 vídeo y de imagen a vídeo, consulta periódicamente la `polling_url` devuelta y descarga el vídeo terminado desde las `unsigned_urls` de OpenRouter o desde el punto de conexión de contenido del trabajo. De forma predeterminada, las imágenes de referencia se usan como fotogramas iniciales o finales; las imágenes etiquetadas como `reference_image` se envían en su lugar como referencias de entrada. El modelo `google/veo-3.1-fast` incluido de forma predeterminada admite duraciones de 4, 6 y 8 segundos, resoluciones `720P` y `1080P`, y relaciones de aspecto `16:9` y `9:16`. La conversión de vídeo a vídeo no es compatible: la API ascendente solo acepta referencias de texto e imágenes. ## Generación de música OpenRouter puede respaldar la herramienta `music_generate` mediante la salida de audio de finalizaciones de chat. Configura 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 `google/lyria-3-pro-preview` de forma predeterminada y también ofrece `google/lyria-3-clip-preview`. OpenClaw envía `modalities: ["text", "audio"]`, transmite la respuesta, recopila los fragmentos de audio y guarda el resultado como contenido multimedia generado para entregarlo al canal. Los modelos Lyria aceptan una imagen de referencia mediante el parámetro compartido `music_generate image=...`. El audio en transmisión, la conservación de la transcripción y el contenedor de eventos SSE derivado están limitados por `agents.defaults.mediaMaxMb` (el límite de audio predeterminado es de 16 MB). ## Texto a voz OpenRouter puede actuar como proveedor de TTS mediante su endpoint compatible con OpenAI `/audio/speech`. ```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 recurre a `models.providers.openrouter.apiKey` y, después, a `OPENROUTER_API_KEY`. ## Conversión de voz a texto (audio entrante) OpenRouter puede transcribir archivos adjuntos de voz o audio entrantes mediante la ruta compartida `tools.media.audio`, usando su endpoint de STT (`/audio/transcriptions`). Esto se aplica a cualquier Plugin de canal que reenvíe voz o audio entrante a la comprobació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 de STT de OpenRouter como JSON con el audio en base64 dentro de `input_audio` (el contrato de STT de OpenRouter), no como cargas de formulario OpenAI multipartes. ## Enrutador Fusion OpenRouter Fusion envía una referencia de modelo de OpenClaw a varios modelos de OpenRouter en paralelo, hace que OpenRouter evalúe sus respuestas y devuelve una única respuesta final mediante el endpoint normal de OpenRouter. El identificador del modelo ascendente es `openrouter/fusion`, por lo que la referencia de modelo de OpenClaw incluye tanto el prefijo del proveedor de OpenClaw como el espacio de nombres ascendente de OpenRouter: ```bash openclaw models set openrouter/openrouter/fusion ``` Configure el panel y el modelo evaluador de Fusion mediante `params.extraBody` del modelo; esos campos se reenvían directamente al cuerpo de la solicitud de finalización de chat de OpenRouter. Fusion funciona con la incorporación mediante OAuth o mediante clave de API; si usa OAuth, omita la línea `env.OPENROUTER_API_KEY` que aparece a continuación. ```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", }, ], }, }, }, }, }, }, } ``` `analysis_models` es el panel paralelo; `model` dentro de la configuración del Plugin Fusion es el modelo evaluador. No establezca `tool_choice` en el nivel superior como `"required"` en turnos normales del agente o del chat para intentar forzar Fusion: los turnos de OpenClaw pueden incluir sus propias definiciones de herramientas, y una selección de herramienta obligatoria en el nivel superior podría elegir una de ellas en lugar del enrutador Fusion. Cuando esta configuración del Plugin Fusion está presente, OpenClaw añade una nota depurada al mensaje del sistema que enumera los modelos de análisis y el modelo evaluador configurados, para que el agente pueda responder preguntas sobre su propio panel Fusion. Los demás campos de `extraBody` no se copian en el mensaje. Fusion es más lento por diseño: OpenRouter distribuye el mensaje entre varios modelos de análisis y, después, ejecuta un paso de evaluación y síntesis, por lo que la latencia es mayor que la de una solicitud directa a un solo modelo. Úselo para obtener respuestas meditadas y de alta calidad o para rutas de escalamiento, no como opción predeterminada cuando la latencia sea crítica. Mantenga el panel pequeño y elija modelos de análisis y evaluación más rápidos para obtener respuestas con mayor rapidez. Pruebe una referencia configurada con una llamada local 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 un token Bearer de tu clave de API. OAuth de OpenRouter es un flujo de inicio de sesión PKCE que emite una clave de API de OpenRouter, por lo que OpenClaw almacena el resultado en el mismo perfil de autenticación mediante clave de API `openrouter:default` que se utiliza en la configuración manual de la clave de API. Para iniciar sesión o rotar la clave almacenada en una instalación existente sin volver a ejecutar todo el proceso de incorporación: ```bash openclaw models auth login --provider openrouter --method oauth openclaw models auth login --provider openrouter --method api-key ``` En las solicitudes verificadas de OpenRouter (`https://openrouter.ai/api/v1`), OpenClaw añade los encabezados documentados de atribución de aplicaciones 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 de OpenRouter a otro proxy o URL base, OpenClaw **no** inserta esos encabezados específicos de OpenRouter ni los marcadores de caché de Anthropic. ## Configuración avanzada El almacenamiento en caché de respuestas de OpenRouter es opcional. Actívalo para cada 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 sustitución. Se aceptan los alias en snake_case (`response_cache`, `response_cache_ttl_seconds`, `response_cache_clear`), así como `responseCacheTtl` / `response_cache_ttl` sin el sufijo `Seconds`. Esto es independiente del almacenamiento en caché de prompts del proveedor y de los marcadores `cache_control` de Anthropic de OpenRouter. Solo se aplica a rutas verificadas de `openrouter.ai`, no a URL base de proxies personalizados. En las rutas verificadas de OpenRouter, las referencias de modelos de Anthropic conservan los marcadores `cache_control` de Anthropic de OpenRouter para mejorar la reutilización de la caché de prompts en los bloques de prompts del sistema y del desarrollador. En las rutas verificadas de OpenRouter, las referencias de modelos de Anthropic con el razonamiento habilitado eliminan los turnos finales de prefill del asistente antes de que la solicitud llegue a OpenRouter, de conformidad con el requisito de Anthropic de que las conversaciones de razonamiento terminen con un turno del usuario. En las rutas compatibles distintas de `auto`, OpenClaw asigna el nivel de pensamiento seleccionado a las cargas útiles de razonamiento del proxy de OpenRouter. `openrouter/auto` y las indicaciones de modelos no compatibles omiten esa inyección. Las referencias obsoletas de `openrouter/hunter-alpha` también la omiten, porque OpenRouter podía devolver el texto de la respuesta final en los campos de razonamiento de esa ruta retirada. En las rutas verificadas de OpenRouter, `openrouter/deepseek/deepseek-v4-flash` y `openrouter/deepseek/deepseek-v4-pro` completan el valor `reasoning_content` ausente en los turnos reproducidos del asistente, manteniendo las conversaciones de pensamiento y uso de herramientas con el formato de seguimiento requerido por DeepSeek V4. OpenClaw envía los valores de `reasoning.effort` compatibles con OpenRouter para estas rutas: `xhigh`/`max` se asignan a `xhigh`; cualquier otro nivel que no esté desactivado se asigna a `high`. OpenRouter utiliza la ruta compatible con OpenAI al estilo de un proxy, por lo que no se reenvían adaptaciones de solicitudes exclusivas de OpenAI nativo, como `serviceTier`, `store` de Responses, las cargas útiles de compatibilidad con el razonamiento de OpenAI y las indicaciones de caché de prompts. Las referencias de OpenRouter respaldadas por Gemini permanecen en la ruta de proxy de Gemini: OpenClaw mantiene allí el saneamiento de las firmas de pensamiento de Gemini, pero no habilita la validación nativa de reproducción 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 en snake_case documentados por 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 específicos de cada modelo anulan el objeto de enrutamiento general del proveedor: ```json5 { agents: { defaults: { models: { "openrouter/anthropic/claude-sonnet-4-6": { params: { provider: { order: ["anthropic"], allow_fallbacks: false, }, }, }, }, }, }, } ``` Esto solo se aplica a las rutas de finalización de chat de OpenRouter. Las rutas directas de Anthropic, Google, OpenAI o proveedores personalizados ignoran los parámetros de enrutamiento de OpenRouter. ## Relacionado Selección de proveedores, referencias de modelos y comportamiento de conmutación por error. Referencia completa de configuración para agentes, modelos y proveedores.