OpenRouter

OpenRouter achemine les requêtes vers de nombreux modèles derrière une API et une clé uniques. Il est compatible avec OpenAI ; OpenClaw communique donc avec lui via le même transport de type openai-completions que celui utilisé pour les autres fournisseurs proxy.

Prise en main

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>

Exemple de configuration

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

Références des modèles

Modèles de secours intégrés, utilisés lorsque la découverte du catalogue en temps réel est indisponible :

Toute autre référence openrouter/<provider>/<model>, notamment openrouter/openrouter/fusion (voir Routeur Fusion), est résolue dynamiquement à partir du catalogue de modèles en temps réel d'OpenRouter.

Génération d'images

OpenRouter peut servir de moteur à l'outil image_generate. Définissez un modèle d'image OpenRouter dans 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 envoie les requêtes d'images à l'API d'images de complétion de chat d'OpenRouter avec modalities: ["image", "text"]. Les modèles d'images Gemini reçoivent également des indications aspectRatio et resolution via le paramètre image_config d'OpenRouter, contrairement aux autres modèles d'images. Utilisez agents.defaults.imageGenerationModel.timeoutMs pour les modèles plus lents ; la valeur timeoutMs propre à chaque appel de l'outil image_generate reste prioritaire.

Génération de vidéos

OpenRouter peut servir de moteur à l'outil video_generate via son API asynchrone /videos. Définissez un modèle vidéo OpenRouter dans agents.defaults.videoGenerationModel :

{  env: { OPENROUTER_API_KEY: "sk-or-..." },  agents: {    defaults: {      videoGenerationModel: {        primary: "openrouter/google/veo-3.1-fast",      },    },  },}

OpenClaw soumet des tâches de génération de texte en vidéo et d'image en vidéo, interroge périodiquement l'adresse polling_url renvoyée et télécharge la vidéo terminée depuis les unsigned_urls d'OpenRouter ou le point d'accès au contenu de la tâche. Les images de référence sont utilisées par défaut comme images de première ou de dernière trame ; celles portant l'étiquette reference_image sont plutôt envoyées comme références d'entrée. Le modèle par défaut intégré google/veo-3.1-fast prend en charge des durées de 4, 6 ou 8 secondes, les résolutions 720P et 1080P, ainsi que les formats d'image 16:9 et 9:16. La génération de vidéo à partir d'une vidéo n'est pas prise en charge : l'API en amont accepte uniquement du texte et des références d'images.

Génération musicale

OpenRouter peut servir de moteur à l'outil music_generate via la sortie audio des complétions de chat. Définissez un modèle audio OpenRouter dans agents.defaults.musicGenerationModel :

{  env: { OPENROUTER_API_KEY: "sk-or-..." },  agents: {    defaults: {      musicGenerationModel: {        primary: "openrouter/google/lyria-3-pro-preview",        timeoutMs: 180_000,      },    },  },}

Le fournisseur de musique OpenRouter intégré utilise google/lyria-3-pro-preview par défaut et propose également google/lyria-3-clip-preview. OpenClaw envoie modalities: ["text", "audio"], diffuse la réponse en continu, collecte les fragments audio et enregistre le résultat comme média généré pour sa diffusion sur le canal. Les modèles Lyria acceptent une image de référence via le paramètre partagé music_generate image=.... La diffusion audio en continu, la conservation de la transcription et l'enveloppe d'événements SSE dérivée sont limitées par agents.defaults.mediaMaxMb (la limite audio par défaut est de 16 Mo).

Synthèse vocale

OpenRouter peut servir de fournisseur TTS grâce à son point de terminaison compatible avec OpenAI /audio/speech.

{  messages: {    tts: {      auto: "always",      provider: "openrouter",      providers: {        openrouter: {          model: "hexgrad/kokoro-82m",          speakerVoice: "af_alloy",          responseFormat: "mp3",        },      },    },  },}

Si messages.tts.providers.openrouter.apiKey est omis, le TTS utilise comme solutions de repli models.providers.openrouter.apiKey, puis OPENROUTER_API_KEY.

Transcription vocale (audio entrant)

OpenRouter peut transcrire les pièces jointes vocales/audio entrantes par le chemin partagé tools.media.audio, à l’aide de son point de terminaison STT (/audio/transcriptions). Cela s’applique à tout Plugin de canal qui transmet les contenus vocaux/audio entrants à la phase préalable de compréhension des médias.

{  tools: {    media: {      audio: {        enabled: true,        models: [{ provider: "openrouter", model: "openai/whisper-large-v3-turbo" }],      },    },  },}

OpenClaw envoie les requêtes STT à OpenRouter au format JSON, avec l’audio encodé en base64 sous input_audio conformément au contrat STT d’OpenRouter, et non sous forme d’envois de formulaires OpenAI multiparties.

Routeur Fusion

OpenRouter Fusion envoie une référence de modèle OpenClaw à plusieurs modèles OpenRouter en parallèle, demande à OpenRouter d’évaluer leurs réponses, puis renvoie une réponse finale par le point de terminaison OpenRouter habituel. L’identifiant de modèle en amont est openrouter/fusion ; la référence de modèle OpenClaw contient donc à la fois le préfixe de fournisseur OpenClaw et l’espace de noms OpenRouter en amont :

openclaw models set openrouter/openrouter/fusion

Configurez le panel et le modèle d’évaluation de Fusion par l’intermédiaire de params.extraBody du modèle ; ces champs sont transmis directement dans le corps de la requête de complétion de conversation OpenRouter. Fusion fonctionne avec l’intégration OAuth comme avec celle par clé API ; si vous utilisez OAuth, omettez la ligne env.OPENROUTER_API_KEY ci-dessous.

{  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 correspond au panel parallèle ; model, dans la configuration du Plugin Fusion, correspond au modèle d’évaluation. Ne définissez pas le paramètre tool_choice de premier niveau sur "required" lors des échanges normaux avec l’agent ou dans la conversation pour tenter de forcer Fusion : les échanges OpenClaw peuvent inclure leurs propres définitions d’outils, et un choix d’outil obligatoire au premier niveau peut sélectionner l’un de ces outils plutôt que le routeur Fusion. Lorsque cette configuration du Plugin Fusion est présente, OpenClaw ajoute au message système une note assainie qui répertorie les modèles d’analyse configurés et le modèle d’évaluation, afin que l’agent puisse répondre aux questions concernant son propre panel Fusion. Les autres champs de extraBody ne sont pas copiés dans le message.

Fusion est plus lent par conception : OpenRouter distribue le message à plusieurs modèles d’analyse, puis exécute une étape d’évaluation et de synthèse. La latence est donc supérieure à celle d’une requête directe adressée à un seul modèle. Utilisez-le pour obtenir des réponses réfléchies et de haute qualité ou pour les chemins d’escalade, et non comme option par défaut lorsque la latence est critique. Limitez le nombre de modèles du panel et choisissez des modèles d’analyse et d’évaluation plus rapides pour obtenir des réponses plus rapidement.

Testez une référence configurée avec un appel local unique :

openclaw infer model run --local \  --model openrouter/openrouter/fusion \  --prompt "Reply with exactly: FUSION_OK" \  --json

Authentification et en-têtes

OpenRouter utilise un jeton Bearer provenant de votre clé API. OAuth OpenRouter est un flux de connexion PKCE qui délivre une clé API OpenRouter ; OpenClaw stocke donc le résultat dans le même profil d’authentification par clé API openrouter:default que celui utilisé lors de la configuration manuelle d’une clé API.

Pour vous connecter ou renouveler la clé stockée sur une installation existante sans recommencer l’intégralité de l’intégration :

openclaw models auth login --provider openrouter --method oauthopenclaw models auth login --provider openrouter --method api-key

Sur les requêtes OpenRouter vérifiées (https://openrouter.ai/api/v1), OpenClaw ajoute les en-têtes d’attribution d’application documentés par OpenRouter :

Configuration avancée

{  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,            },          },        },      },    },  },}

Voir aussi