Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenRouter stellt eine einheitliche API bereit, die Anfragen über einen einzelnen Endpoint und API-Schlüssel an viele Modelle weiterleitet. Sie ist OpenAI-kompatibel, daher funktionieren die meisten OpenAI-SDKs durch Wechsel der Basis-URL.

​
Erste Schritte

1

API-Schlüssel abrufen

Erstellen Sie einen API-Schlüssel unter openrouter.ai/keys.
2

Onboarding ausführen

openclaw onboard --auth-choice openrouter-api-key
3

(Optional) Zu einem bestimmten Modell wechseln

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

​
Modellreferenzen

Modellreferenzen 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:
ModellreferenzHinweise
openrouter/autoAutomatisches Routing von OpenRouter
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-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-Jobs an OpenRouter, pollt die zurückgegebene polling_url und lädt das fertige Video von OpenRouters unsigned_urls oder dem dokumentierten Job-Content-Endpoint herunter. Referenzbilder werden standardmäßig als Bilder für das erste/letzte Frame gesendet; Bilder, die mit reference_image markiert sind, werden als OpenRouter-Eingabereferenzen gesendet. Der gebündelte Standard google/veo-3.1-fast gibt die derzeit unterstützten Dauern von 4/6/8 Sekunden, Auflösungen 720P/1080P und Seitenverhältnisse 16:9/9:16 an. Video-zu-Video ist für OpenRouter nicht registriert, weil die vorgelagerte Videogenerierungs-API derzeit Text- und Bildreferenzen akzeptiert.

​
Text-to-Speech

OpenRouter kann auch als TTS-Provider über seinen OpenAI-kompatiblen /audio/speech-Endpoint verwendet werden. 
{
  messages: {
    tts: {
      auto: "always",
      provider: "openrouter",
      providers: {
        openrouter: {
          model: "hexgrad/kokoro-82m",
          voice: "af_alloy",
          responseFormat: "mp3",
        },
      },
    },
  },
}
Wenn messages.tts.providers.openrouter.apiKey ausgelassen wird, verwendet TTS erneut models.providers.openrouter.apiKey, dann OPENROUTER_API_KEY.

​
Speech-to-Text (eingehendes Audio)

OpenRouter kann eingehende Sprach-/Audioanhänge über den gemeinsamen Pfad tools.media.audio mit seinem STT-Endpoint (/audio/transcriptions) transkribieren. Dies gilt für jedes Channel-Plugin, das eingehende Sprach-/Audiodaten an den Media-Understanding-Preflight 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 mehrteilige OpenAI-Formular-Uploads.

​
Authentifizierung und Header

OpenRouter verwendet intern ein Bearer-Token mit Ihrem API-Schlüssel. 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-Antwort-Caching ist Opt-in. 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-Aliasse (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 verifizierten openrouter.ai-Routen angewendet, nicht auf benutzerdefinierte Proxy-Basis-URLs.
Auf verifizierten OpenRouter-Routen behalten Anthropic-Modellreferenzen die OpenRouter-spezifischen Anthropic-cache_control-Marker bei, 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, entsprechend Anthropics Anforderung, dass Reasoning-Konversationen mit einem User- 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 ausgemusterte Route endgültigen 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 bei wiedergegebenen Assistant-Turns auf, damit Thinking-/Tool-Konversationen die für DeepSeek V4 erforderliche Follow-up-Form beibehalten. OpenClaw sendet von OpenRouter unterstützte reasoning_effort-Werte für diese Routen; xhigh ist die höchste beworbene Stufe, und veraltete max-Overrides werden auf xhigh abgebildet.
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äts-Payloads und Prompt-Cache-Hinweise nicht weitergeleitet.
Gemini-gestützte OpenRouter-Referenzen bleiben auf dem Proxy-Gemini-Pfad: OpenClaw behält dort die Gemini-Thought-Signature-Bereinigung bei, aktiviert aber keine native Gemini- Replay-Validierung oder Bootstrap-Rewrites.
Wenn Sie OpenRouter-Provider-Routing unter Modellparametern übergeben, leitet OpenClaw es als OpenRouter-Routing-Metadaten weiter, bevor die gemeinsamen Stream-Wrapper ausgeführt werden.

​
Verwandte Themen

Modellauswahl

Provider, Modellreferenzen und Failover-Verhalten auswählen.

Konfigurationsreferenz

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