Zum Hauptinhalt springen
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

1

Run OAuth onboarding

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

(Optional) Switch to a specific model

Onboarding verwendet standardmäßig openrouter/auto. Wählen Sie später ein konkretes Modell aus:
openclaw models set openrouter/<provider>/<model>

​
Konfigurationsbeispiel

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

​
Modell-Referenzen

Modell-Refs folgen dem Muster openrouter/<provider>/<model>. Die vollständige Liste der verfügbaren Provider und Modelle finden Sie unter /concepts/model-providers.
Gebündelte Fallback-Beispiele:
Modell-RefHinweise
openrouter/autoAutomatisches OpenRouter-Routing
openrouter/openrouter/fusionOpenRouter Fusion-Router
openrouter/moonshotai/kimi-k2.6Kimi K2.6 über MoonshotAI
openrouter/moonshotai/kimi-k2.5Kimi K2.5 über MoonshotAI

​
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:
HeaderWert
HTTP-Refererhttps://openclaw.ai
X-OpenRouter-TitleOpenClaw
X-OpenRouter-Categoriescli-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:
{
  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:
{
  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:
{
  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

Modellauswahl

Provider, Modellreferenzen und Failover-Verhalten auswählen.

Konfigurationsreferenz

Vollständige Konfigurationsreferenz für Agents, Modelle und Provider.