OpenRouter

OpenRouter, istekleri tek bir API ve tek bir anahtarın arkasındaki birçok modele yönlendirir. OpenAI uyumlu olduğundan OpenClaw, diğer proxy sağlayıcıları için 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 paketle birlikte gelen yedek modeller:

openrouter/openrouter/fusion (Fusion yönlendiricisi bölümüne bakın) dahil 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.mediaModels.image 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 üzerinden aspectRatio ve resolution ipuçlarını alır; diğer görüntü modelleri almaz. Daha yavaş modeller için agents.defaults.mediaModels.image.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.mediaModels.video 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 değerini yoklar ve tamamlanan videoyu OpenRouter'ın unsigned_urls uç noktası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 olarak etiketlenen görüntüler bunun yerine girdi referansları olarak gönderilir. Paketle birlikte gelen google/veo-3.1-fast varsayılanı, 4/6/8 saniyelik süreleri, 720P/1080P çözünürlüklerini ve 16:9/9:16 en-boy oranlarını destekler. Videodan videoya dönüştürme desteklenmez: üst kaynak API yalnızca metin ve görüntü referanslarını kabul eder.

Müzik oluşturma

OpenRouter, sohbet tamamlama ses çıkışı üzerinden music_generate aracını destekleyebilir. agents.defaults.mediaModels.music 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,      },    },  },}

Paketle birlikte gelen 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 seçeneğini sunar. OpenClaw, modalities: ["text", "audio"] gönderir, yanıtı akış halinde alır, ses parçalarını toplar ve sonucu kanala teslim edilmek üzere oluşturulan medya olarak kaydeder. Lyria modelleri, paylaşılan music_generate image=... parametresi üzerinden tek bir referans görüntü kabul eder. Ses akışı, 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.

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

tts.providers.openrouter.apiKey belirtilmezse TTS sırasıyla models.providers.openrouter.apiKey ve ardından OPENROUTER_API_KEY seçeneklerine geri döner.

Konuşmadan metne dönüştürme (gelen ses)

OpenRouter, paylaşılan tools.media.audio yolu üzerinden STT uç noktasını (/audio/transcriptions) kullanarak gelen sesli mesajların/ses dosyalarının yazıya dökümünü yapabilir. Bu, gelen sesli mesajları/ses dosyalarını medya anlama ön kontrolüne ileten tüm kanal pluginleri 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, bir OpenClaw model başvurusunu 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 slug'ı openrouter/fusion olduğundan OpenClaw model başvurusu hem OpenClaw sağlayıcı önekini hem de üst OpenRouter ad alanını taşır:

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 etkileşimlerinde Fusion'ı zorlamak amacıyla üst düzey tool_choice değerini "required" olarak ayarlamayın: OpenClaw etkileşimleri 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, temizlenmiş 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 modelli bir istekten daha yüksektir. Gecikmeye duyarlı bir varsayılan olarak değil, özenli ve yüksek kaliteli yanıtlar ya da yükseltme yolları için kullanın. Daha hızlı yanıtlar için paneli küçük tutun ve daha hızlı analiz/değerlendirici modeller seçin.

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

openclaw infer model run --local \  --model openrouter/openrouter/fusion \  --prompt "Tam olarak şununla yanıt ver: FUSION_OK" \  --json

Kimlik doğrulama ve üstbilgiler

OpenRouter, API anahtarınızdaki bir Bearer belirteci kullanır. OpenRouter OAuth, bir OpenRouter API anahtarı veren bir 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 profilinde saklar.

Tam ilk katılım sürecini yeniden çalıştırmadan mevcut bir kurulumda oturum açmak veya saklanan anahtarı değiştirmek 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