OpenRouter

OpenRouter routeert aanvragen naar veel modellen achter één API en één sleutel. Het is compatibel met OpenAI, zodat OpenClaw ermee communiceert via hetzelfde openai-completions-achtige transport dat voor andere proxyproviders wordt gebruikt.

Aan de slag

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>

Configuratievoorbeeld

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

Modelverwijzingen

Meegeleverde fallbackmodellen, gebruikt wanneer live catalogusdetectie niet beschikbaar is:

Elke andere openrouter/<provider>/<model>-verwijzing, waaronder openrouter/openrouter/fusion (zie Fusion-router), wordt dynamisch omgezet aan de hand van de live modelcatalogus van OpenRouter.

Afbeeldingen genereren

OpenRouter kan de image_generate-tool ondersteunen. Stel een OpenRouter-afbeeldingsmodel in onder agents.defaults.mediaModels.image:

{  env: { OPENROUTER_API_KEY: "sk-or-..." },  agents: {    defaults: {      imageGenerationModel: {        primary: "openrouter/google/gemini-3.1-flash-image-preview",        timeoutMs: 180_000,      },    },  },}

OpenClaw stuurt afbeeldingsaanvragen naar de chat-completions-afbeeldings-API van OpenRouter met modalities: ["image", "text"]. Gemini-afbeeldingsmodellen ontvangen daarnaast aspectRatio- en resolution-hints via image_config van OpenRouter; andere afbeeldingsmodellen niet. Gebruik agents.defaults.mediaModels.image.timeoutMs voor langzamere modellen; de timeoutMs per aanroep van de image_generate-tool heeft nog steeds voorrang.

Video's genereren

OpenRouter kan de video_generate-tool ondersteunen via zijn asynchrone /videos-API. Stel een OpenRouter-videomodel in onder agents.defaults.mediaModels.video:

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

OpenClaw dient tekst-naar-video- en afbeelding-naar-video-taken in, controleert periodiek de geretourneerde polling_url en downloadt de voltooide video via unsigned_urls van OpenRouter of het inhoudseindpunt van de taak. Referentieafbeeldingen worden standaard gebruikt als afbeeldingen voor het eerste/laatste frame; afbeeldingen met de tag reference_image worden in plaats daarvan als invoerreferenties verzonden. De meegeleverde standaardwaarde google/veo-3.1-fast ondersteunt duurwaarden van 4/6/8 seconden, resoluties van 720P/1080P en beeldverhoudingen van 16:9/9:16. Video-naar-video wordt niet ondersteund: de upstream-API accepteert alleen tekst- en afbeeldingsreferenties.

Muziek genereren

OpenRouter kan de music_generate-tool ondersteunen via audio-uitvoer van chat-completions. Stel een OpenRouter-audiomodel in onder agents.defaults.mediaModels.music:

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

De meegeleverde OpenRouter-muziekprovider gebruikt standaard google/lyria-3-pro-preview en stelt ook google/lyria-3-clip-preview beschikbaar. OpenClaw stuurt modalities: ["text", "audio"], streamt het antwoord, verzamelt de audiofragmenten en slaat het resultaat op als gegenereerde media voor levering via kanalen. Lyria-modellen accepteren één referentieafbeelding via de gedeelde parameter music_generate image=.... Streamingaudio, transcriptbewaring en de afgeleide SSE-eventenvelop worden begrensd door agents.defaults.mediaMaxMb (de standaard audiolimiet is 16 MB).

Tekst-naar-spraak

OpenRouter kan als TTS-provider fungeren via het OpenAI-compatibele /audio/speech-endpoint.

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

Als tts.providers.openrouter.apiKey wordt weggelaten, valt TTS terug op models.providers.openrouter.apiKey en vervolgens op OPENROUTER_API_KEY.

Spraak-naar-tekst (inkomende audio)

OpenRouter kan inkomende spraak-/audiobijlagen transcriberen via het gedeelde tools.media.audio-pad, met behulp van het STT-endpoint (/audio/transcriptions). Dit geldt voor elke kanaalplugin die inkomende spraak/audio doorstuurt naar de preflight voor mediabegrip.

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

OpenClaw verzendt OpenRouter STT-verzoeken als JSON met base64-audio onder input_audio (het STT-contract van OpenRouter), niet als multipart OpenAI-formulieruploads.

Fusion-router

OpenRouter Fusion verzendt één OpenClaw-modelreferentie parallel naar meerdere OpenRouter-modellen, laat OpenRouter hun antwoorden beoordelen en retourneert één definitief antwoord via het normale OpenRouter-endpoint. De upstream-modelslug is openrouter/fusion, waardoor de OpenClaw-modelreferentie zowel het OpenClaw-providerprefix als de upstream OpenRouter-namespace bevat:

openclaw models set openrouter/openrouter/fusion

Configureer het panel en het beoordelingsmodel van Fusion via params.extraBody van het model; deze velden worden rechtstreeks doorgestuurd naar de hoofdtekst van het OpenRouter-verzoek voor chatvoltooiingen. Fusion werkt met onboarding via OAuth of een API-sleutel; laat bij gebruik van OAuth de regel env.OPENROUTER_API_KEY hieronder weg.

{  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 is het parallelle panel; model in de Fusion-pluginconfiguratie is het beoordelingsmodel. Stel tijdens normale agent-/chatbeurten tool_choice op het hoogste niveau niet in op "required" om Fusion te proberen af te dwingen: OpenClaw-beurten kunnen eigen tooldefinities bevatten en een verplichte toolkeuze op het hoogste niveau kan een daarvan kiezen in plaats van de Fusion-router. Wanneer deze Fusion-pluginconfiguratie aanwezig is, voegt OpenClaw een opgeschoonde systeempromptnotitie toe met een lijst van de geconfigureerde analysemodellen en het beoordelingsmodel, zodat de agent vragen over het eigen Fusion-panel kan beantwoorden. Andere extraBody-velden worden niet naar de prompt gekopieerd.

Fusion is bewust trager: OpenRouter stuurt de prompt naar meerdere analysemodellen en voert vervolgens een beoordelings-/synthesestap uit, waardoor de latentie hoger is dan bij een directe aanvraag aan één model. Gebruik het voor weloverwogen antwoorden van hoge kwaliteit of escalatiepaden, niet als latentiegevoelige standaardinstelling. Houd het panel klein en kies snellere analyse- en beoordelingsmodellen voor snellere antwoorden.

Test een geconfigureerde referentie met een eenmalige lokale aanroep:

openclaw infer model run --local \  --model openrouter/openrouter/fusion \  --prompt "Antwoord exact met: FUSION_OK" \  --json

Authenticatie en headers

OpenRouter gebruikt een Bearer-token uit je API-sleutel. OpenRouter OAuth is een PKCE- aanmeldingsflow die een OpenRouter API-sleutel verstrekt, zodat OpenClaw het resultaat opslaat in hetzelfde openrouter:default-authenticatieprofiel voor API-sleutels dat wordt gebruikt bij handmatige configuratie van een API-sleutel.

Om je aan te melden of de opgeslagen sleutel in een bestaande installatie te vervangen zonder de volledige onboarding opnieuw uit te voeren:

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

Bij geverifieerde OpenRouter-verzoeken (https://openrouter.ai/api/v1) voegt OpenClaw de gedocumenteerde headers voor app-toeschrijving van OpenRouter toe:

Geavanceerde configuratie

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

Gerelateerd