OpenRouter

OpenRouter proporciona una API unificada que enruta solicitudes a muchos modelos detrás de un único punto de conexión y una 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-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 modelos

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 completaciones de chat de OpenRouter con modalities: ["image", "text"]. Los modelos de imagen de Gemini reciben indicaciones admitidas de aspectRatio y resolution mediante image_config de OpenRouter. Usa agents.defaults.imageGenerationModel.timeoutMs para los 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 e imagen a video a OpenRouter, sondea el polling_url devuelto y descarga el video completado desde los unsigned_urls de OpenRouter o desde el punto de conexión de contenido del trabajo documentado. Las imágenes de referencia se envían como imágenes de fotograma inicial/final 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 admitidas 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 de generación de video ascendente actualmente acepta texto y referencias de imagen.

# Texto a voz

OpenRouter también se puede usar 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",
          voice: "af_alloy",
          responseFormat: "mp3",
        },
      },
    },
  },
}

Si se omite messages.tts.providers.openrouter.apiKey, TTS reutiliza models.providers.openrouter.apiKey y luego OPENROUTER_API_KEY.

# 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 añade los encabezados de atribución de aplicación documentados de OpenRouter:

# Configuración avanzada

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

# Relacionado