Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

1

Obtén tu clave de API

Crea una clave de API en openrouter.ai/keys.
2

Ejecuta la incorporación

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

(Opcional) Cambia a un modelo específico

La incorporación usa openrouter/auto de forma predeterminada. Elige un modelo concreto más adelante:
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

Las referencias de modelo siguen el patrón openrouter/<provider>/<model>. Para ver la lista completa de proveedores y modelos disponibles, consulta /concepts/model-providers.
Ejemplos de respaldo incluidos:
Referencia de modeloNotas
openrouter/autoEnrutamiento automático de OpenRouter
openrouter/moonshotai/kimi-k2.6Kimi K2.6 mediante MoonshotAI
openrouter/moonshotai/kimi-k2.5Kimi 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: 
{
  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: 
{
  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. 
{
  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. 
{
  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:
EncabezadoValor
HTTP-Refererhttps://openclaw.ai
X-OpenRouter-TitleOpenClaw
X-OpenRouter-Categoriescli-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:
{
  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

Selección de modelos

Elección de proveedores, referencias de modelo y comportamiento de conmutación por error.

Referencia de configuración

Referencia completa de configuración para agentes, modelos y proveedores.