OpenRouter

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

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

Modell-Referenzen

Gebündelte Fallback-Beispiele:

Bildgenerierung

OpenRouter kann auch das Tool image_generate unterstützen. Verwenden Sie ein OpenRouter-Bildmodell unter 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 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:

{  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:

{  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.

{  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.

{  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:

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.

{  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:

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:

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:

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

Verwandt