OpenRouter

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

# Erste Schritte

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

# Bilderzeugung

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 die Chat-Completions-Bild-API von OpenRouter mit modalities: ["image", "text"]. Gemini-Bildmodelle erhalten unterstützte Hinweise für aspectRatio und resolution über image_config von OpenRouter. Verwenden Sie agents.defaults.imageGenerationModel.timeoutMs für langsamere OpenRouter-Bildmodelle; der timeoutMs-Parameter pro Aufruf des Tools image_generate hat weiterhin Vorrang.

# Videoerzeugung

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, fragt die zurückgegebene polling_url ab und lädt das fertige Video von unsigned_urls von OpenRouter oder dem dokumentierten Job-Inhaltsendpunkt herunter. Referenzbilder werden standardmäßig als Bilder für den ersten/letzten Frame gesendet; Bilder, die mit reference_image markiert sind, werden als OpenRouter-Eingabereferenzen gesendet. Der mitgelieferte Standard google/veo-3.1-fast bewirbt die derzeit unterstützten Dauern von 4/6/8 Sekunden, Auflösungen 720P/1080P und Seitenverhältnisse 16:9/9:16. Video-zu-Video ist für OpenRouter nicht registriert, da die vorgelagerte Videoerzeugungs-API derzeit Text- und Bildreferenzen 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",
          voice: "af_alloy",
          responseFormat: "mp3",
        },
      },
    },
  },
}

Wenn messages.tts.providers.openrouter.apiKey ausgelassen wird, verwendet TTS erneut models.providers.openrouter.apiKey und danach OPENROUTER_API_KEY.

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

# Erweiterte Konfiguration

{
  agents: {
    defaults: {
      models: {
        "openrouter/auto": {
          params: {
            responseCache: true,
            responseCacheTtlSeconds: 300,
          },
        },
      },
    },
  },
}

# Verwandte Themen