OpenRouter

OpenRouter biedt een uniforme API die aanvragen routeert naar veel modellen achter één endpoint en API-sleutel. Deze is OpenAI-compatibel, dus de meeste OpenAI-SDK's werken door de basis-URL te wijzigen.

# Aan de slag

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

openclaw models set openrouter/<provider>/<model>

# Configuratievoorbeeld

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

# Modelreferenties

Voorbeelden van meegeleverde fallbacks:

# Afbeeldingen genereren

OpenRouter kan ook de image_generate-tool ondersteunen. Gebruik een OpenRouter-afbeeldingsmodel onder 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 stuurt afbeeldingsaanvragen naar OpenRouters chat-completions-afbeeldings-API met modalities: ["image", "text"]. Gemini-afbeeldingsmodellen ontvangen ondersteunde hints voor aspectRatio en resolution via OpenRouters image_config. Gebruik agents.defaults.imageGenerationModel.timeoutMs voor tragere OpenRouter-afbeeldingsmodellen; de parameter timeoutMs per aanroep van de image_generate-tool heeft nog steeds voorrang.

# Video's genereren

OpenRouter kan ook de video_generate-tool ondersteunen via de asynchrone /videos-API. Gebruik een OpenRouter-videomodel onder agents.defaults.videoGenerationModel:

{
  env: { OPENROUTER_API_KEY: "sk-or-..." },
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "openrouter/google/veo-3.1-fast",
      },
    },
  },
}

OpenClaw dient tekst-naar-video- en afbeelding-naar-video-taken in bij OpenRouter, pollt de geretourneerde polling_url en downloadt de voltooide video via OpenRouters unsigned_urls of het gedocumenteerde endpoint voor taakinhoud. Referentieafbeeldingen worden standaard verzonden als afbeeldingen voor het eerste/laatste frame; afbeeldingen met de tag reference_image worden verzonden als OpenRouter-invoerreferenties. De meegeleverde standaard google/veo-3.1-fast vermeldt de momenteel ondersteunde duur van 4/6/8 seconden, resoluties 720P/1080P en beeldverhoudingen 16:9/9:16. Video-naar-video is niet geregistreerd voor OpenRouter, omdat de upstream API voor videogeneratie momenteel tekst- en afbeeldingsreferenties accepteert.

# Tekst-naar-spraak

OpenRouter kan ook worden gebruikt als TTS-provider via het OpenAI-compatibele /audio/speech-endpoint.

{
  messages: {
    tts: {
      auto: "always",
      provider: "openrouter",
      providers: {
        openrouter: {
          model: "hexgrad/kokoro-82m",
          voice: "af_alloy",
          responseFormat: "mp3",
        },
      },
    },
  },
}

Als messages.tts.providers.openrouter.apiKey wordt weggelaten, hergebruikt TTS models.providers.openrouter.apiKey en daarna OPENROUTER_API_KEY.

# Authenticatie en headers

OpenRouter gebruikt onder de motorkap een Bearer-token met je API-sleutel.

Bij echte OpenRouter-aanvragen (https://openrouter.ai/api/v1) voegt OpenClaw ook OpenRouters gedocumenteerde app-toewijzingsheaders toe:

# Geavanceerde configuratie

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

# Gerelateerd