OpenRouter

OpenRouter leitet Anfragen über eine API und einen Schlüssel an viele Modelle weiter. Es ist OpenAI-kompatibel, sodass OpenClaw über denselben Transport im openai-completions-Stil mit ihm kommuniziert, 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 Fallback-Modelle, die verwendet werden, wenn die Live-Katalogerkennung nicht verfügbar ist:

Jede andere openrouter/<provider>/<model>-Referenz, einschließlich openrouter/openrouter/fusion (siehe Fusion-Router), wird dynamisch anhand des Live-Modellkatalogs von OpenRouter aufgelöst.

Bilderzeugung

OpenRouter kann das Tool image_generate bereitstellen. Legen Sie ein OpenRouter-Bildmodell unter agents.defaults.mediaModels.image 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 Chat-Completions-Bild-API von OpenRouter. Gemini-Bildmodelle erhalten zusätzlich die Hinweise aspectRatio und resolution über image_config von OpenRouter; andere Bildmodelle erhalten sie nicht. Verwenden Sie agents.defaults.mediaModels.image.timeoutMs für langsamere Modelle; der pro Aufruf gesetzte Wert timeoutMs des Tools image_generate hat weiterhin Vorrang.

Videoerzeugung

OpenRouter kann das Tool video_generate über seine asynchrone /videos-API bereitstellen. Legen Sie ein OpenRouter-Videomodell unter agents.defaults.mediaModels.video fest:

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

OpenClaw übermittelt Text-zu-Video- und Bild-zu-Video-Aufträge, fragt den zurückgegebenen polling_url ab und lädt das fertige Video von unsigned_urls von OpenRouter oder vom Inhaltsendpunkt des Auftrags herunter. Referenzbilder werden standardmäßig als Bilder des ersten/letzten Frames verwendet; mit reference_image markierte Bilder werden stattdessen als Eingabereferenzen gesendet. Der mitgelieferte Standard google/veo-3.1-fast unterstützt Dauern von 4/6/8 Sekunden, Auflösungen von 720P/1080P und Seitenverhältnisse von 16:9/9:16. Video-zu-Video wird nicht unterstützt: Die vorgelagerte API akzeptiert nur Text- und Bildreferenzen.

Musikerzeugung

OpenRouter kann das Tool music_generate über die Audioausgabe von Chat-Completions bereitstellen. Legen Sie ein OpenRouter-Audiomodell unter agents.defaults.mediaModels.music 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 Kanalauslieferung. Lyria-Modelle akzeptieren ein Referenzbild über den gemeinsamen Parameter music_generate image=.... Streaming-Audio, die Aufbewahrung von Transkripten und die abgeleitete SSE-Ereignishülle werden durch agents.defaults.mediaMaxMb begrenzt (das standardmäßige Audiolimit beträgt 16 MB).

Text-to-Speech

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

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

Wenn tts.providers.openrouter.apiKey weggelassen wird, greift TTS zunächst auf models.providers.openrouter.apiKey und anschließend auf OPENROUTER_API_KEY zurück.

Speech-to-Text (eingehendes Audio)

OpenRouter kann eingehende Sprach-/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 Sprache/Audio an die Vorprüfung für das Medienverständnis weiterleitet.

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

OpenClaw sendet OpenRouter-STT-Anfragen gemäß dem STT-Vertrag von OpenRouter als JSON mit Base64-Audio unter input_audio und nicht als mehrteilige OpenAI-Formular- Uploads.

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 vorgelagerte Modell-Slug lautet openrouter/fusion, daher enthält die OpenClaw-Modellreferenz sowohl das OpenClaw- Provider-Präfix als auch den vorgelagerten OpenRouter-Namensraum:

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 Textkörper der Chat-Completions-Anfrage von OpenRouter weitergeleitet. Fusion funktioniert sowohl mit OAuth- als auch mit API-Schlüssel-Onboarding. Wenn Sie OAuth verwenden, lassen Sie die folgende 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 in der Konfiguration des Fusion-Plugins ist das Bewertungsmodell. Setzen Sie tool_choice auf oberster Ebene bei normalen Agenten-/Chat-Durchläufen nicht auf "required", um Fusion zu erzwingen: OpenClaw-Durchläufe können eigene Tooldefinitionen enthalten, und eine auf oberster Ebene vorgeschriebene Toolauswahl könnte eines davon anstelle des Fusion-Routers auswählen. Wenn diese Fusion-Plugin-Konfiguration vorhanden ist, fügt OpenClaw einen bereinigten System-Prompt-Hinweis hinzu, der die konfigurierten Analysemodelle und das Bewertungsmodell auflistet, sodass der Agent Fragen zu seinem eigenen Fusion- Panel beantworten kann. Andere extraBody-Felder werden nicht in den Prompt kopiert.

Fusion ist absichtlich langsamer: OpenRouter verteilt den Prompt auf mehrere Analysemodelle und führt anschließend einen Bewertungs-/Syntheseschritt aus, sodass die Latenz höher ist als bei einer direkten Anfrage an ein einzelnes Modell. Verwenden Sie Fusion für wohlüberlegte, hochwertige Antworten oder Eskalationspfade und nicht als latenzempfindlichen Standard. Halten Sie das Panel klein und wählen Sie für schnellere Antworten schnellere Analyse-/Bewertungsmodelle.

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 bei der manuellen Einrichtung eines API-Schlüssels verwendet wird.

So melden Sie sich bei einer vorhandenen Installation an oder wechseln den gespeicherten Schlüssel, ohne das vollständige Onboarding 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 App-Zuordnungs-Header 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