OpenRouter

OpenRouter leitet Anfragen über eine API und einen Schlüssel an zahlreiche Modelle weiter. Es ist OpenAI-kompatibel, daher kommuniziert OpenClaw damit über denselben Transport im Stil von openai-completions, der auch für andere Proxy-Provider verwendet wird.

Erste Schritte

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>

Konfigurationsbeispiel

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

Modellreferenzen

Mitgelieferte Ausweichmodelle, die verwendet werden, wenn die Live-Katalogerkennung nicht verfügbar ist:

Alle anderen Referenzen im Format openrouter/<provider>/<model>, einschließlich openrouter/openrouter/fusion (siehe Fusion-Router), werden dynamisch anhand des Live-Modellkatalogs von OpenRouter aufgelöst.

Bilderzeugung

OpenRouter kann als Backend für das Werkzeug image_generate dienen. Legen Sie unter agents.defaults.imageGenerationModel ein OpenRouter-Bildmodell fest:

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

OpenClaw sendet Bildanfragen mit modalities: ["image", "text"] an die Bild-API für Chat-Vervollständigungen von OpenRouter. Gemini-Bildmodelle erhalten über image_config von OpenRouter zusätzlich Hinweise für aspectRatio und resolution; andere Bildmodelle erhalten diese nicht. Verwenden Sie agents.defaults.imageGenerationModel.timeoutMs für langsamere Modelle; der aufrufbezogene Wert timeoutMs des Werkzeugs image_generate hat weiterhin Vorrang.

Videoerzeugung

OpenRouter kann über seine asynchrone /videos-API als Backend für das Werkzeug video_generate dienen. Legen Sie unter agents.defaults.videoGenerationModel ein OpenRouter-Videomodell fest:

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

OpenClaw übermittelt Aufträge zur Text-zu-Video- und Bild-zu-Video-Erzeugung, fragt die zurückgegebene polling_url regelmäßig ab und lädt das fertige Video über die unsigned_urls von OpenRouter oder den Inhaltsendpunkt des Auftrags herunter. Referenzbilder werden standardmäßig als Bilder für das erste beziehungsweise letzte Einzelbild verwendet; mit reference_image gekennzeichnete Bilder werden stattdessen als Eingabereferenzen gesendet. Der mitgelieferte Standard google/veo-3.1-fast unterstützt eine Dauer von 4, 6 oder 8 Sekunden, die Auflösungen 720P und 1080P sowie die Seitenverhältnisse 16:9 und 9:16. Video-zu-Video wird nicht unterstützt: Die vorgelagerte API akzeptiert nur Text- und Bildreferenzen.

Musikerzeugung

OpenRouter kann über die Audioausgabe von Chat-Vervollständigungen als Backend für das Werkzeug music_generate dienen. Legen Sie unter agents.defaults.musicGenerationModel ein OpenRouter-Audiomodell fest:

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

Der mitgelieferte OpenRouter-Musik-Provider verwendet standardmäßig google/lyria-3-pro-preview und stellt außerdem google/lyria-3-clip-preview bereit. OpenClaw sendet modalities: ["text", "audio"], streamt die Antwort, sammelt die Audiosegmente und speichert das Ergebnis als erzeugtes Medium für die Auslieferung über den Kanal. Lyria-Modelle akzeptieren über den gemeinsamen Parameter music_generate image=... ein Referenzbild. Streaming-Audio, die Aufbewahrung des Transkripts und die daraus abgeleitete SSE-Ereignishülle werden durch agents.defaults.mediaMaxMb begrenzt (die standardmäßige Audiogrenze beträgt 16 MB).

Text-zu-Sprache

OpenRouter kann über seinen OpenAI-kompatiblen Endpunkt /audio/speech als TTS-Provider dienen.

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

Wenn messages.tts.providers.openrouter.apiKey nicht angegeben ist, greift TTS zunächst auf models.providers.openrouter.apiKey und anschließend auf OPENROUTER_API_KEY zurück.

Sprache-zu-Text (eingehendes Audio)

OpenRouter kann eingehende Sprach- und Audioanhänge über den gemeinsamen Pfad tools.media.audio mithilfe seines STT-Endpunkts (/audio/transcriptions) transkribieren. Dies gilt für jedes Kanal-Plugin, das eingehende Sprach- oder Audiodaten an die Vorprüfung der Medienerkennung weiterleitet.

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

OpenClaw sendet STT-Anfragen an OpenRouter als JSON mit Base64-kodierten Audiodaten unter input_audio (gemäß dem STT-Vertrag von OpenRouter), nicht als mehrteilige OpenAI-Formularuploads.

Fusion-Router

OpenRouter Fusion sendet eine OpenClaw-Modellreferenz parallel an mehrere OpenRouter-Modelle, lässt OpenRouter deren Antworten bewerten und gibt über den normalen OpenRouter-Endpunkt eine endgültige Antwort zurück. Der Modellbezeichner der vorgelagerten API lautet openrouter/fusion, weshalb die OpenClaw-Modellreferenz sowohl das OpenClaw-Providerpräfix als auch den vorgelagerten OpenRouter-Namensraum enthält:

openclaw models set openrouter/openrouter/fusion

Konfigurieren Sie das Panel und das Bewertungsmodell von Fusion über params.extraBody des Modells; diese Felder werden direkt an den Anfragetext für OpenRouter-Chat-Vervollständigungen weitergeleitet. Fusion funktioniert sowohl mit der OAuth- als auch mit der API-Schlüssel-Einrichtung. Wenn Sie OAuth verwenden, lassen Sie die nachfolgende Zeile env.OPENROUTER_API_KEY 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 ist das parallele Panel; model innerhalb der Konfiguration des Fusion-Plugins ist das Bewertungsmodell. Setzen Sie bei normalen Agenten- oder Chat-Durchläufen nicht das übergeordnete tool_choice auf "required", um Fusion zu erzwingen: OpenClaw-Durchläufe können eigene Werkzeugdefinitionen enthalten, und eine übergeordnete verpflichtende Werkzeugauswahl kann statt des Fusion-Routers eines dieser Werkzeuge auswählen. Wenn diese Fusion-Plugin-Konfiguration vorhanden ist, ergänzt OpenClaw den System-Prompt um einen bereinigten Hinweis, der die konfigurierten Analysemodelle und das Bewertungsmodell aufführt. Dadurch kann der Agent Fragen zu seinem eigenen Fusion-Panel beantworten. Andere extraBody-Felder werden nicht in den Prompt kopiert.

Fusion ist absichtlich langsamer: OpenRouter verteilt den Prompt an mehrere Analysemodelle und führt anschließend einen Bewertungs- und Syntheseschritt aus. Daher ist die Latenz höher als bei einer direkten Anfrage an ein einzelnes Modell. Verwenden Sie Fusion für sorgfältig erarbeitete, hochwertige Antworten oder Eskalationspfade, nicht als latenzempfindliche Standardeinstellung. Halten Sie das Panel klein und wählen Sie schnellere Analyse- und Bewertungsmodelle, um kürzere Antwortzeiten zu erzielen.

Testen Sie eine konfigurierte Referenz mit einem einmaligen lokalen Aufruf:

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

Authentifizierung und Header

OpenRouter verwendet ein Bearer-Token aus Ihrem API-Schlüssel. OpenRouter OAuth ist ein PKCE-Anmeldeablauf, der einen OpenRouter-API-Schlüssel ausstellt. Daher speichert OpenClaw das Ergebnis im selben API-Schlüssel-Authentifizierungsprofil openrouter:default, das auch bei der manuellen Einrichtung eines API-Schlüssels verwendet wird.

Um sich bei einer vorhandenen Installation anzumelden oder den gespeicherten Schlüssel zu rotieren, ohne die vollständige Einrichtung erneut auszuführen:

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

Bei verifizierten OpenRouter-Anfragen (https://openrouter.ai/api/v1) fügt OpenClaw die dokumentierten Header zur App-Zuordnung von OpenRouter hinzu:

Erweiterte Konfiguration

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

Verwandte Themen