OpenRouter

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

openclaw onboard --auth-choice openrouter-oauth

openclaw models set openrouter/<provider>/<model>

openclaw onboard --auth-choice openrouter-api-key

openclaw models set openrouter/<provider>/<model>

Ejemplo de configuración

{  env: { OPENROUTER_API_KEY: "sk-or-..." },  agents: {    defaults: {      model: { primary: "openrouter/auto" },    },  },}

Referencias de modelo

Ejemplos de reserva incluidos:

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:

{  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:

{  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:

{  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.

{  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.

{  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:

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.

{  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:

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:

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:

Configuración avanzada

{  agents: {    defaults: {      models: {        "openrouter/auto": {          params: {            responseCache: true,            responseCacheTtlSeconds: 300,          },        },      },    },  },}

{  models: {    providers: {      openrouter: {        params: {          provider: {            sort: "latency",            require_parameters: true,            data_collection: "deny",          },        },      },    },  },}

{  agents: {    defaults: {      models: {        "openrouter/anthropic/claude-sonnet-4-6": {          params: {            provider: {              order: ["anthropic"],              allow_fallbacks: false,            },          },        },      },    },  },}

Relacionado