OpenRouter

OpenRouter, istekleri tek bir API ve tek bir anahtar üzerinden birçok modele yönlendirir. OpenAI uyumlu olduğundan OpenClaw, diğer proxy sağlayıcılarında kullanılan aynı openai-completions tarzı aktarım üzerinden onunla iletişim kurar.

Başlarken

openclaw onboard --auth-choice openrouter-oauth

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

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

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

Yapılandırma örneği

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

Model referansları

Canlı katalog keşfi kullanılamadığında kullanılan paketlenmiş yedek modeller:

openrouter/openrouter/fusion (Fusion yönlendiricisi bölümüne bakın) dahil olmak üzere diğer tüm openrouter/<provider>/<model> referansları, OpenRouter'ın canlı model kataloğuna göre dinamik olarak çözümlenir.

Görüntü oluşturma

OpenRouter, image_generate aracını destekleyebilir. agents.defaults.imageGenerationModel altında bir OpenRouter görüntü modeli ayarlayın:

{  env: { OPENROUTER_API_KEY: "sk-or-..." },  agents: {    defaults: {      imageGenerationModel: {        primary: "openrouter/google/gemini-3.1-flash-image-preview",        timeoutMs: 180_000,      },    },  },}

OpenClaw, görüntü isteklerini modalities: ["image", "text"] ile OpenRouter'ın sohbet tamamlama görüntü API'sine gönderir. Gemini görüntü modelleri ayrıca OpenRouter'ın image_config alanı üzerinden aspectRatio ve resolution ipuçlarını alır; diğer görüntü modelleri almaz. Daha yavaş modeller için agents.defaults.imageGenerationModel.timeoutMs kullanın; image_generate aracının çağrı başına timeoutMs değeri yine önceliklidir.

Video oluşturma

OpenRouter, eşzamansız /videos API'si üzerinden video_generate aracını destekleyebilir. agents.defaults.videoGenerationModel altında bir OpenRouter video modeli ayarlayın:

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

OpenClaw, metinden videoya ve görüntüden videoya işleri gönderir, döndürülen polling_url adresini yoklar ve tamamlanan videoyu OpenRouter'ın unsigned_urls alanından veya iş içeriği uç noktasından indirir. Referans görüntüler varsayılan olarak ilk/son kare görüntüleri şeklinde kullanılır; reference_image etiketi taşıyan görüntüler ise bunun yerine giriş referansları olarak gönderilir. Paketlenmiş varsayılan google/veo-3.1-fast, 4/6/8 saniyelik süreleri, 720P/1080P çözünürlükleri ve 16:9/9:16 en-boy oranlarını destekler. Videodan videoya dönüştürme desteklenmez: üst API yalnızca metin ve görüntü referanslarını kabul eder.

Müzik oluşturma

OpenRouter, sohbet tamamlama ses çıktısı üzerinden music_generate aracını destekleyebilir. agents.defaults.musicGenerationModel altında bir OpenRouter ses modeli ayarlayın:

{  env: { OPENROUTER_API_KEY: "sk-or-..." },  agents: {    defaults: {      musicGenerationModel: {        primary: "openrouter/google/lyria-3-pro-preview",        timeoutMs: 180_000,      },    },  },}

Paketlenmiş OpenRouter müzik sağlayıcısı varsayılan olarak google/lyria-3-pro-preview kullanır ve ayrıca google/lyria-3-clip-preview modelini sunar. OpenClaw, modalities: ["text", "audio"] gönderir, yanıtı akış halinde alır, ses parçalarını toplar ve sonucu kanal üzerinden teslim edilmek üzere oluşturulmuş medya olarak kaydeder. Lyria modelleri, ortak music_generate image=... parametresi üzerinden bir referans görüntüyü kabul eder. Akış halindeki ses, transkript saklama ve türetilmiş SSE olay zarfı agents.defaults.mediaMaxMb ile sınırlandırılır (varsayılan ses sınırı 16 MB'dir).

Metinden konuşmaya

OpenRouter, OpenAI uyumlu /audio/speech uç noktası üzerinden bir TTS sağlayıcısı olarak çalışabilir.

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

messages.tts.providers.openrouter.apiKey belirtilmezse TTS, önce models.providers.openrouter.apiKey değerine, ardından OPENROUTER_API_KEY değerine geri döner.

Konuşmadan metne (gelen ses)

OpenRouter, ortak tools.media.audio yolu üzerinden, STT uç noktasını (/audio/transcriptions) kullanarak gelen sesli mesaj/ses eklerini yazıya dökebilir. Bu, gelen sesli mesajları/sesleri medya anlama ön kontrolüne ileten tüm kanal Plugin'leri için geçerlidir.

{  tools: {    media: {      audio: {        enabled: true,        models: [{ provider: "openrouter", model: "openai/whisper-large-v3-turbo" }],      },    },  },}

OpenClaw, OpenRouter STT isteklerini çok parçalı OpenAI form yüklemeleri olarak değil, input_audio altında base64 ses içeren JSON biçiminde (OpenRouter'ın STT sözleşmesi) gönderir.

Fusion yönlendiricisi

OpenRouter Fusion, tek bir OpenClaw model referansını paralel olarak birden fazla OpenRouter modeline gönderir, yanıtları OpenRouter'a değerlendirtir ve normal OpenRouter uç noktası üzerinden tek bir nihai yanıt döndürür. Üst model kısa adı openrouter/fusion olduğundan OpenClaw model referansı hem OpenClaw sağlayıcı önekini hem de üst OpenRouter ad alanını içerir:

openclaw models set openrouter/openrouter/fusion

Fusion'ın panelini ve değerlendiricisini modelin params.extraBody alanı üzerinden yapılandırın; bu alanlar doğrudan OpenRouter sohbet tamamlama isteği gövdesine iletilir. Fusion, hem OAuth hem de API anahtarıyla ilk kurulumla çalışır; OAuth kullanıyorsanız aşağıdaki env.OPENROUTER_API_KEY satırını atlayın.

{  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",                },              ],            },          },        },      },    },  },}

analysis_models paralel paneldir; Fusion Plugin yapılandırmasındaki model ise değerlendirici modeldir. Normal ajan/sohbet işlemlerinde Fusion'ı zorlamak amacıyla üst düzey tool_choice değerini "required" olarak ayarlamayın: OpenClaw işlemleri kendi araç tanımlarını içerebilir ve üst düzey zorunlu araç seçimi, Fusion yönlendiricisi yerine bunlardan birini seçebilir. Bu Fusion Plugin yapılandırması mevcut olduğunda OpenClaw, yapılandırılmış analiz modellerini ve değerlendirici modeli listeleyen arındırılmış bir sistem istemi notu ekler; böylece ajan kendi Fusion paneli hakkındaki soruları yanıtlayabilir. Diğer extraBody alanları isteme kopyalanmaz.

Fusion tasarım gereği daha yavaştır: OpenRouter, istemi birden fazla analiz modeline dağıtır ve ardından bir değerlendirme/sentez adımı çalıştırır; bu nedenle gecikme, doğrudan tek model isteğine göre daha yüksektir. Gecikmeye duyarlı bir varsayılan olarak değil, bilinçli ve yüksek kaliteli yanıtlar veya yükseltme yolları için kullanın. Paneli küçük tutun ve daha hızlı yanıtlar için daha hızlı analiz/değerlendirici modelleri seçin.

Yapılandırılmış bir referansı tek seferlik yerel çağrıyla test edin:

openclaw infer model run --local \  --model openrouter/openrouter/fusion \  --prompt "Reply with exactly: FUSION_OK" \  --json

Kimlik doğrulama ve üstbilgiler

OpenRouter, API anahtarınızdan alınan bir Bearer belirteci kullanır. OpenRouter OAuth, bir OpenRouter API anahtarı veren PKCE oturum açma akışıdır; bu nedenle OpenClaw sonucu, manuel API anahtarı kurulumunda kullanılan aynı openrouter:default API anahtarı kimlik doğrulama profiline kaydeder.

Tam ilk kurulumu yeniden çalıştırmadan mevcut bir kurulumda oturum açmak veya kayıtlı anahtarı yenilemek için:

openclaw models auth login --provider openrouter --method oauthopenclaw models auth login --provider openrouter --method api-key

Doğrulanmış OpenRouter isteklerinde (https://openrouter.ai/api/v1) OpenClaw, OpenRouter'ın belgelenmiş uygulama ilişkilendirme üstbilgilerini ekler:

Gelişmiş yapılandırma

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

{  models: {    providers: {      openrouter: {        params: {          provider: {            sort: "latency",            require_parameters: true,            data_collection: "deny",          },        },      },    },  },}

{  agents: {    defaults: {      models: {        "openrouter/anthropic/claude-sonnet-4-6": {          params: {            provider: {              order: ["anthropic"],              allow_fallbacks: false,            },          },        },      },    },  },}

İlgili