Naar hoofdinhoud gaan

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 biedt een uniforme API die verzoeken naar veel modellen routeert achter één eindpunt en API-sleutel. Het is OpenAI-compatibel, waardoor de meeste OpenAI SDK’s werken door de basis-URL te wijzigen.

​
Aan de slag

1

Get your API key

Maak een API-sleutel aan op openrouter.ai/keys.
2

Run onboarding

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

(Optional) Switch to a specific model

Onboarding gebruikt standaard openrouter/auto. Kies later een concreet model:
openclaw models set openrouter/<provider>/<model>

​
Configuratievoorbeeld

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

​
Modelverwijzingen

Modelverwijzingen volgen het patroon openrouter/<provider>/<model>. Zie /concepts/model-providers voor de volledige lijst met beschikbare providers en modellen.
Meegeleverde fallback-voorbeelden:
ModelverwijzingOpmerkingen
openrouter/autoAutomatische routing van OpenRouter
openrouter/moonshotai/kimi-k2.6Kimi K2.6 via MoonshotAI

​
Afbeeldingen genereren

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

​
Video genereren

OpenRouter kan ook het hulpprogramma video_generate ondersteunen via zijn 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 van OpenRouter’s unsigned_urls of het gedocumenteerde inhoudseindpunt voor taken. Referentieafbeeldingen worden standaard als eerste/laatste frame-afbeeldingen verzonden; afbeeldingen met de tag reference_image worden verzonden als OpenRouter-invoerreferenties. De meegeleverde standaard google/veo-3.1-fast adverteert de momenteel ondersteunde duren van 4/6/8 seconden, 720P/1080P-resoluties en 16:9/9:16-beeldverhoudingen. 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 zijn OpenAI-compatibele /audio/speech-eindpunt. 
{
  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-verzoeken (https://openrouter.ai/api/v1) voegt OpenClaw ook OpenRouter’s gedocumenteerde app-toeschrijvingsheaders toe:
HeaderWaarde
HTTP-Refererhttps://openclaw.ai
X-OpenRouter-TitleOpenClaw
X-OpenRouter-Categoriescli-agent
Als je de OpenRouter-provider naar een andere proxy of basis-URL verwijst, injecteert OpenClaw deze OpenRouter-specifieke headers of Anthropic-cachemarkeringen niet.

​
Geavanceerde configuratie

Op geverifieerde OpenRouter-routes behouden Anthropic-modelverwijzingen de OpenRouter-specifieke Anthropic cache_control-markeringen die OpenClaw gebruikt voor beter hergebruik van de prompt-cache op systeem-/ontwikkelaarspromptblokken.
Op ondersteunde niet-auto-routes koppelt OpenClaw het geselecteerde denkniveau aan reasoning-payloads van de OpenRouter-proxy. Niet-ondersteunde modelhints en openrouter/auto slaan die reasoning-injectie over. Hunter Alpha slaat ook proxy-reasoning over voor verouderde geconfigureerde modelverwijzingen, omdat OpenRouter definitieve antwoordtekst in reasoning-velden kon retourneren voor die ingetrokken route.
OpenRouter loopt nog steeds via het proxy-achtige OpenAI-compatibele pad, dus native OpenAI-only verzoekvormgeving zoals serviceTier, Responses store, OpenAI reasoning-compat-payloads en prompt-cachehints worden niet doorgestuurd.
Door Gemini ondersteunde OpenRouter-verwijzingen blijven op het proxy-Gemini-pad: OpenClaw behoudt daar Gemini thought-signature-sanering, maar schakelt geen native Gemini replay-validatie of bootstrap-herschrijvingen in.
Als je OpenRouter-provider-routing doorgeeft onder modelparameters, stuurt OpenClaw dit door als OpenRouter-routingmetadata voordat de gedeelde stream-wrappers worden uitgevoerd.

​
Gerelateerd

Model selection

Providers, modelverwijzingen en failover-gedrag kiezen.

Configuration reference

Volledige configuratiereferentie voor agents, modellen en providers.