--- read_when: - Sie möchten einen einzigen API-Schlüssel für viele LLMs - Sie möchten Modelle über OpenRouter in OpenClaw ausführen - Sie möchten OpenRouter für die Bildgenerierung verwenden - Sie möchten OpenRouter für die Musikgenerierung verwenden - Sie möchten OpenRouter für die Videogenerierung verwenden summary: Verwenden Sie die einheitliche API von OpenRouter, um in OpenClaw auf viele Modelle zuzugreifen title: OpenRouter x-i18n: generated_at: "2026-07-03T09:33:07Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: ca36f2a7afd35ea4d276f61ded28524aed7d15715b29eea9aaac0ac6e4abab40 source_path: providers/openrouter.md workflow: 16 --- OpenRouter stellt eine **einheitliche API** bereit, die Anfragen an viele Modelle hinter einem einzigen Endpunkt und API-Schlüssel weiterleitet. Sie ist OpenAI-kompatibel, sodass die meisten OpenAI SDKs durch Wechseln der Basis-URL funktionieren. ## Erste Schritte ```bash openclaw onboard --auth-choice openrouter-oauth ``` OpenClaw öffnet den Browser-Anmeldefluss von OpenRouter, tauscht den PKCE- Code gegen einen OpenRouter-API-Schlüssel aus und speichert diesen Schlüssel im standardmäßigen OpenRouter-Authentifizierungsprofil. Auf Remote- oder Headless-Hosts gibt OpenClaw die Anmelde-URL aus und fordert Sie auf, nach der Anmeldung die Weiterleitungs-URL einzufügen. Onboarding verwendet standardmäßig `openrouter/auto`. Wählen Sie später ein konkretes Modell aus: ```bash openclaw models set openrouter// ``` Erstellen Sie einen API-Schlüssel unter [openrouter.ai/keys](https://openrouter.ai/keys). ```bash openclaw onboard --auth-choice openrouter-api-key ``` Onboarding verwendet standardmäßig `openrouter/auto`. Wählen Sie später ein konkretes Modell aus: ```bash openclaw models set openrouter// ``` ## Konfigurationsbeispiel ```json5 { env: { OPENROUTER_API_KEY: "sk-or-..." }, agents: { defaults: { model: { primary: "openrouter/auto" }, }, }, } ``` ## Modell-Referenzen Modell-Refs folgen dem Muster `openrouter//`. Die vollständige Liste der verfügbaren Provider und Modelle finden Sie unter [/concepts/model-providers](/de/concepts/model-providers). Gebündelte Fallback-Beispiele: | Modell-Ref | Hinweise | | --------------------------------- | ------------------------------ | | `openrouter/auto` | Automatisches OpenRouter-Routing | | `openrouter/openrouter/fusion` | OpenRouter Fusion-Router | | `openrouter/moonshotai/kimi-k2.6` | Kimi K2.6 über MoonshotAI | | `openrouter/moonshotai/kimi-k2.5` | Kimi K2.5 über MoonshotAI | ## Bildgenerierung OpenRouter kann auch das Tool `image_generate` unterstützen. Verwenden Sie ein OpenRouter-Bildmodell unter `agents.defaults.imageGenerationModel`: ```json5 { env: { OPENROUTER_API_KEY: "sk-or-..." }, agents: { defaults: { imageGenerationModel: { primary: "openrouter/google/gemini-3.1-flash-image-preview", timeoutMs: 180_000, }, }, }, } ``` OpenClaw sendet Bildanfragen an OpenRouters Chat-Completions-Bild-API mit `modalities: ["image", "text"]`. Gemini-Bildmodelle erhalten unterstützte Hinweise zu `aspectRatio` und `resolution` über OpenRouters `image_config`. Verwenden Sie `agents.defaults.imageGenerationModel.timeoutMs` für langsamere OpenRouter-Bildmodelle; der pro Aufruf gesetzte Parameter `timeoutMs` des Tools `image_generate` hat weiterhin Vorrang. ## Videogenerierung OpenRouter kann auch das Tool `video_generate` über seine asynchrone `/videos`-API unterstützen. Verwenden Sie ein OpenRouter-Videomodell unter `agents.defaults.videoGenerationModel`: ```json5 { 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 an OpenRouter, fragt die zurückgegebene `polling_url` ab und lädt das fertiggestellte Video über OpenRouters `unsigned_urls` oder den dokumentierten Endpunkt für Auftragsinhalte herunter. Referenzbilder werden standardmäßig als Bilder für das erste bzw. letzte Frame gesendet; Bilder mit dem Tag `reference_image` werden als OpenRouter-Eingabereferenzen gesendet. Der gebündelte Standard `google/veo-3.1-fast` weist die derzeit unterstützten Dauern von 4/6/8 Sekunden, die Auflösungen `720P`/`1080P` und die Seitenverhältnisse `16:9`/`9:16` aus. Video-zu-Video ist für OpenRouter nicht registriert, da die Upstream- Videogenerierungs-API derzeit Text- und Bildreferenzen akzeptiert. ## Musikgenerierung OpenRouter kann auch das Tool `music_generate` über Audioausgabe aus Chat Completions unterstützen. Verwenden Sie ein OpenRouter-Audiomodell unter `agents.defaults.musicGenerationModel`: ```json5 { env: { OPENROUTER_API_KEY: "sk-or-..." }, agents: { defaults: { musicGenerationModel: { primary: "openrouter/google/lyria-3-pro-preview", timeoutMs: 180_000, }, }, }, } ``` Der gebündelte 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"]`, aktiviert Streaming, sammelt die gestreamten Audio-Chunks und speichert das Ergebnis als generierte Medien für die Kanalzustellung. Referenzbilder werden für Lyria-Modelle über den gemeinsamen Parameter `music_generate image=...` akzeptiert. ## Text-to-Speech OpenRouter kann auch als TTS-Provider über seinen OpenAI-kompatiblen Endpunkt `/audio/speech` verwendet werden. ```json5 { messages: { tts: { auto: "always", provider: "openrouter", providers: { openrouter: { model: "hexgrad/kokoro-82m", speakerVoice: "af_alloy", responseFormat: "mp3", }, }, }, }, } ``` Wenn `messages.tts.providers.openrouter.apiKey` ausgelassen wird, verwendet TTS erneut `models.providers.openrouter.apiKey` und danach `OPENROUTER_API_KEY`. ## Speech-to-Text (eingehendes Audio) OpenRouter kann eingehende Sprach-/Audioanhänge über den gemeinsamen Pfad `tools.media.audio` mit seinem STT-Endpunkt (`/audio/transcriptions`) transkribieren. Dies gilt für jedes Channel-Plugin, das eingehende Sprach-/Audiodaten in die Vorprüfung für Medienverständnis weiterleitet. ```json5 { tools: { media: { audio: { enabled: true, models: [{ provider: "openrouter", model: "openai/whisper-large-v3-turbo" }], }, }, }, } ``` OpenClaw sendet OpenRouter-STT-Anfragen als JSON mit Base64-Audio unter `input_audio` (OpenRouter-STT-Vertrag), nicht als multipart OpenAI-Formular-Uploads. ## Fusion-Router Verwenden Sie OpenRouter Fusion, wenn eine OpenClaw-Modell-Ref mehrere OpenRouter-Modelle parallel befragen soll, OpenRouter deren Antworten bewerten soll und eine einzelne finale Antwort über den normalen OpenRouter-Provider-Endpunkt zurückgeben soll. Da der Upstream-Modell-Slug `openrouter/fusion` ist, enthält die OpenClaw-Modell-Ref sowohl das OpenClaw-Provider-Präfix als auch den Upstream-OpenRouter-Namespace: ```bash openclaw models set openrouter/openrouter/fusion ``` Konfigurieren Sie das Panel und das Judge-Modell von Fusion über `params.extraBody` des Modells. Diese Felder werden in den OpenRouter-Chat-Completions-Anfragetext weitergeleitet. Fusion funktioniert sowohl mit OpenRouter-OAuth-Onboarding als auch mit API-Schlüssel-Onboarding; wenn Sie OAuth verwenden, lassen Sie die Zeile `env.OPENROUTER_API_KEY` im folgenden Beispiel weg. ```json5 { 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", }, ], }, }, }, }, }, }, } ``` Die Liste `analysis_models` ist das parallele Panel, und `model` innerhalb der Fusion- Plugin-Konfiguration ist das Judge-Modell. Setzen Sie `tool_choice` auf oberster Ebene in normalen OpenClaw-Agent-/Chat-Durchläufen nicht auf `"required"`, um Fusion erzwingen zu wollen; OpenClaw-Durchläufe können OpenClaw-Tool-Definitionen enthalten, und eine erforderliche Tool-Auswahl auf oberster Ebene kann eines dieser Tools statt des Fusion-Routers verlangen. Wenn diese Fusion-Plugin-Konfiguration vorhanden ist, fügt OpenClaw außerdem eine bereinigte System-Prompt-Notiz mit den konfigurierten Analysemodellen und dem Judge-Modell hinzu, damit der Agent Fragen zu seinem aktuellen Fusion-Panel beantworten kann. Andere `extraBody`- Felder werden nicht in den Prompt kopiert. Fusion ist absichtlich langsamer. OpenRouter kann denselben OpenClaw-Prompt an mehrere Analysemodelle senden und anschließend einen finalen Judge-/Synthese-Schritt ausführen, daher ist die Latenz normalerweise höher als bei einer direkten Einzelmodell-Anfrage. Verwenden Sie Fusion für überlegte, hochwertige Antworten oder Eskalationspfade, nicht als Standard für latenzempfindlichen Chat. Für schnellere Antworten halten Sie das Panel klein und wählen Sie schnellere Analyse- und Judge-Modelle. Testen Sie die konfigurierte Ref mit einem einmaligen lokalen Modellaufruf: ```bash openclaw infer model run --local \ --model openrouter/openrouter/fusion \ --prompt "Reply with exactly: FUSION_OK" \ --json ``` ## Authentifizierung und Header OpenRouter verwendet intern ein Bearer-Token mit Ihrem API-Schlüssel. OpenRouter- OAuth ist ein PKCE-Anmeldefluss, der einen OpenRouter-API-Schlüssel ausstellt, sodass OpenClaw das Ergebnis als dasselbe `openrouter:default`-API-Schlüssel-Authentifizierungsprofil speichert, das auch vom manuellen API-Schlüssel-Einrichtungspfad verwendet wird. Melden Sie sich bei einer bestehenden Installation an oder rotieren Sie den gespeicherten OpenRouter-Schlüssel, ohne das vollständige Onboarding erneut auszuführen: ```bash openclaw models auth login --provider openrouter --method oauth ``` Verwenden Sie `openclaw models auth login --provider openrouter --method api-key`, wenn Sie einen Schlüssel einfügen möchten, den Sie manuell bei OpenRouter erstellt haben. Bei echten OpenRouter-Anfragen (`https://openrouter.ai/api/v1`) fügt OpenClaw außerdem die dokumentierten App-Attributions-Header von OpenRouter hinzu: | Header | Wert | | ------------------------- | ------------------------------------------------------------------------------------------------------ | | `HTTP-Referer` | `https://openclaw.ai` | | `X-OpenRouter-Title` | `OpenClaw` | | `X-OpenRouter-Categories` | `cli-agent,cloud-agent,programming-app,creative-writing,writing-assistant,general-chat,personal-agent` | Wenn Sie den OpenRouter-Provider auf einen anderen Proxy oder eine andere Basis-URL umstellen, injiziert OpenClaw diese OpenRouter-spezifischen Header oder Anthropic-Cache-Marker **nicht**. ## Erweiterte Konfiguration OpenRouter-Response-Caching ist optional. Aktivieren Sie es pro OpenRouter-Modell mit Modellparametern: ```json5 { agents: { defaults: { models: { "openrouter/auto": { params: { responseCache: true, responseCacheTtlSeconds: 300, }, }, }, }, }, } ``` OpenClaw sendet `X-OpenRouter-Cache: true` und, wenn konfiguriert, `X-OpenRouter-Cache-TTL`. `responseCacheClear: true` erzwingt eine Aktualisierung für die aktuelle Anfrage und speichert die Ersatzantwort. Snake_case-Aliase (`response_cache`, `response_cache_ttl_seconds` und `response_cache_clear`) werden ebenfalls akzeptiert. Dies ist getrennt vom Provider-Prompt-Caching und von OpenRouters Anthropic-`cache_control`-Markern. Es wird nur auf verifizierte `openrouter.ai`-Routen angewendet, nicht auf benutzerdefinierte Proxy-Basis-URLs. Auf verifizierten OpenRouter-Routen behalten Anthropic-Modell-Refs die OpenRouter-spezifischen Anthropic-`cache_control`-Marker, die OpenClaw für bessere Prompt-Cache-Wiederverwendung bei System-/Developer-Prompt-Blöcken nutzt. Auf verifizierten OpenRouter-Routen entfernen Anthropic-Modellreferenzen mit aktiviertem Reasoning nachgestellte Assistant-Prefill-Turns, bevor die Anfrage OpenRouter erreicht. Dies entspricht Anthropics Anforderung, dass Reasoning-Unterhaltungen mit einem Benutzer- Turn enden. Auf unterstützten Nicht-`auto`-Routen ordnet OpenClaw die ausgewählte Thinking-Stufe OpenRouter-Proxy-Reasoning-Payloads zu. Nicht unterstützte Modellhinweise und `openrouter/auto` überspringen diese Reasoning-Injektion. Hunter Alpha überspringt außerdem Proxy-Reasoning für veraltete konfigurierte Modellreferenzen, weil OpenRouter für diese eingestellte Route finalen Antworttext in Reasoning-Feldern zurückgeben könnte. Auf verifizierten OpenRouter-Routen füllen `openrouter/deepseek/deepseek-v4-flash` und `openrouter/deepseek/deepseek-v4-pro` fehlendes `reasoning_content` in wiedergegebenen Assistant-Turns auf, damit Thinking-/Tool-Unterhaltungen die von DeepSeek V4 erforderliche Follow-up-Form beibehalten. OpenClaw sendet von OpenRouter unterstützte `reasoning.effort`-Werte für diese Routen; niedrigere Nicht-Off-Stufen werden `high` zugeordnet, und veraltete `max`-Overrides werden `xhigh` zugeordnet. OpenRouter läuft weiterhin über den Proxy-artigen OpenAI-kompatiblen Pfad, daher wird native, nur für OpenAI geltende Anfrageformung wie `serviceTier`, Responses `store`, OpenAI-Reasoning-Kompatibilitätspayloads und Prompt-Cache-Hinweise nicht weitergeleitet. Gemini-gestützte OpenRouter-Referenzen bleiben auf dem Proxy-Gemini-Pfad: OpenClaw behält dort die Bereinigung der Gemini-Thought-Signaturen bei, aktiviert jedoch keine native Gemini- Replay-Validierung oder Bootstrap-Umschreibungen. OpenRouter unterstützt ein `provider`-Anfrageobjekt für das Routing des zugrunde liegenden Providers. Konfigurieren Sie eine Standardrichtlinie für alle OpenRouter-Textmodell-Anfragen mit `models.providers.openrouter.params.provider`: ```json5 { models: { providers: { openrouter: { params: { provider: { sort: "latency", require_parameters: true, data_collection: "deny", }, }, }, }, }, } ``` OpenClaw leitet dieses Objekt als Anfrage-`provider`-Payload an OpenRouter weiter. Verwenden Sie die von OpenRouter dokumentierten snake_case-Felder, einschließlich `sort`, `only`, `ignore`, `order`, `allow_fallbacks`, `require_parameters`, `data_collection`, `quantizations`, `max_price`, `preferred_max_latency`, `preferred_min_throughput`, `zdr` und `enforce_distillable_text`. Pro-Modell-Parameter überschreiben weiterhin das Provider-weite Routing-Objekt: ```json5 { agents: { defaults: { models: { "openrouter/anthropic/claude-sonnet-4-6": { params: { provider: { order: ["anthropic"], allow_fallbacks: false, }, }, }, }, }, }, } ``` Dies gilt nur für OpenRouter-Chat-Completions-Routen. Direkte Anthropic-, Google-, OpenAI- oder benutzerdefinierte Provider-Routen ignorieren OpenRouter-Routing-Parameter. ## Verwandt Provider, Modellreferenzen und Failover-Verhalten auswählen. Vollständige Konfigurationsreferenz für Agents, Modelle und Provider.