Ana içeriğe atla
OpenRouter, istekleri tek bir uç nokta ve API anahtarının arkasındaki birçok modele yönlendiren birleşik bir API sağlar. OpenAI uyumludur, bu nedenle çoğu OpenAI SDK’sı temel URL değiştirilerek çalışır.

​
Başlarken

1

OAuth katılımını çalıştırın

openclaw onboard --auth-choice openrouter-oauth
OpenClaw, OpenRouter’ın tarayıcı oturum açma akışını açar, PKCE kodunu bir OpenRouter API anahtarıyla değiştirir ve bu anahtarı varsayılan OpenRouter kimlik doğrulama profilinde saklar. Uzak/başsız ana makinelerde OpenClaw, oturum açma URL’sini yazdırır ve oturum açtıktan sonra yönlendirme URL’sini yapıştırmanızı ister.
2

(İsteğe bağlı) Belirli bir modele geçin

Katılım varsayılan olarak openrouter/auto kullanır. Daha sonra somut bir model seçin:
openclaw models set openrouter/<provider>/<model>

​
Yapılandırma örneği

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

​
Model başvuruları

Model başvuruları openrouter/<provider>/<model> desenini izler. Kullanılabilir sağlayıcıların ve modellerin tam listesi için bkz. /concepts/model-providers.
Paketlenmiş yedek örnekler:
Model başvurusuNotlar
openrouter/autoOpenRouter otomatik yönlendirme
openrouter/openrouter/fusionOpenRouter Fusion yönlendiricisi
openrouter/moonshotai/kimi-k2.6MoonshotAI üzerinden Kimi K2.6
openrouter/moonshotai/kimi-k2.5MoonshotAI üzerinden Kimi K2.5

​
Görüntü üretimi

OpenRouter, image_generate aracını da destekleyebilir. agents.defaults.imageGenerationModel altında bir OpenRouter görüntü modeli kullanı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 OpenRouter’ın sohbet tamamlama görüntü API’sine modalities: ["image", "text"] ile gönderir. Gemini görüntü modelleri, desteklenen aspectRatio ve resolution ipuçlarını OpenRouter’ın image_config yapılandırması üzerinden alır. Daha yavaş OpenRouter görüntü modelleri için agents.defaults.imageGenerationModel.timeoutMs kullanın; image_generate aracının çağrı başına timeoutMs parametresi yine önceliklidir.

​
Video üretimi

OpenRouter, zaman uyumsuz /videos API’si üzerinden video_generate aracını da destekleyebilir. agents.defaults.videoGenerationModel altında bir OpenRouter video modeli kullanı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 OpenRouter’a gönderir, döndürülen polling_url adresini yoklar ve tamamlanan videoyu OpenRouter’ın unsigned_urls alanından veya belgelenmiş iş içeriği uç noktasından indirir. Referans görüntüler varsayılan olarak ilk/son kare görüntüleri olarak gönderilir; reference_image ile etiketlenen görüntüler OpenRouter giriş referansları olarak gönderilir. Paketlenmiş google/veo-3.1-fast varsayılanı, şu anda desteklenen 4/6/8 saniyelik süreleri, 720P/1080P çözünürlükleri ve 16:9/9:16 en boy oranlarını bildirir. Video üretimi üst API’si şu anda metin ve görüntü referanslarını kabul ettiği için video-videoya OpenRouter için kayıtlı değildir.

​
Müzik üretimi

OpenRouter, sohbet tamamlama ses çıktısı üzerinden music_generate aracını da destekleyebilir. agents.defaults.musicGenerationModel altında bir OpenRouter ses modeli kullanı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 sunar. OpenClaw modalities: ["text", "audio"] gönderir, akışı etkinleştirir, akan ses parçalarını toplar ve sonucu kanal teslimi için üretilmiş medya olarak kaydeder. Referans görüntüler, paylaşılan music_generate image=... parametresi üzerinden Lyria modelleri için kabul edilir.

​
Metinden konuşmaya

OpenRouter, OpenAI uyumlu /audio/speech uç noktası üzerinden bir TTS sağlayıcısı olarak da kullanılabilir. 
{
  messages: {
    tts: {
      auto: "always",
      provider: "openrouter",
      providers: {
        openrouter: {
          model: "hexgrad/kokoro-82m",
          speakerVoice: "af_alloy",
          responseFormat: "mp3",
        },
      },
    },
  },
}
messages.tts.providers.openrouter.apiKey atlanırsa TTS önce models.providers.openrouter.apiKey, ardından OPENROUTER_API_KEY değerini yeniden kullanır.

​
Konuşmadan metne (gelen ses)

OpenRouter, STT uç noktasını (/audio/transcriptions) kullanarak paylaşılan tools.media.audio yolu üzerinden gelen ses/konuşma eklerini yazıya dökebilir. Bu, gelen ses/konuşmayı 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 multipart OpenAI form yüklemeleri olarak değil, input_audio altında base64 ses içeren JSON olarak gönderir (OpenRouter STT sözleşmesi).

​
Fusion yönlendiricisi

Tek bir OpenClaw model başvurusunun birkaç OpenRouter modeline paralel olarak sormasını, OpenRouter’ın yanıtlarını değerlendirmesini ve normal OpenRouter sağlayıcı uç noktası üzerinden tek bir nihai yanıt döndürmesini istediğinizde OpenRouter Fusion kullanın. Üst model kısa adı openrouter/fusion olduğundan, OpenClaw model başvurusu hem OpenClaw sağlayıcı önekini hem de üst OpenRouter ad alanını içerir: 
openclaw models set openrouter/openrouter/fusion
Fusion panelini ve değerlendiricisini modelin params.extraBody alanı üzerinden yapılandırın. Bu alanlar OpenRouter sohbet tamamlama istek gövdesine iletilir. Fusion, OpenRouter OAuth katılımı veya API anahtarı katılımıyla çalışır; OAuth kullanıyorsanız aşağıdaki örnekten env.OPENROUTER_API_KEY satırını çıkarı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 listesi paralel paneldir ve Fusion Plugin yapılandırmasının içindeki model değerlendirici modelidir. Fusion’ı zorlamaya çalışmak için normal OpenClaw agent/sohbet turlarında üst düzey tool_choice değerini "required" olarak ayarlamayın; OpenClaw turları OpenClaw araç tanımlarını içerebilir ve üst düzey zorunlu araç seçimi, Fusion yönlendiricisi yerine bu araçlardan birini gerektirebilir. Bu Fusion Plugin yapılandırması mevcut olduğunda OpenClaw, agent’ın mevcut Fusion paneliyle ilgili soruları yanıtlayabilmesi için yapılandırılmış analiz modellerini ve değerlendirici modelini içeren temizlenmiş bir sistem istemi notu da ekler. Diğer extraBody alanları isteme kopyalanmaz. Fusion tasarımı gereği daha yavaştır. OpenRouter aynı OpenClaw istemini birden çok analiz modeline gönderebilir ve ardından nihai bir değerlendirme/sentez adımı çalıştırabilir; bu nedenle gecikme genellikle doğrudan tek model isteğinden daha yüksektir. Fusion’ı gecikmeye duyarlı sohbet için varsayılan olarak değil, dikkatli, yüksek kaliteli yanıtlar veya yükseltme yolları için kullanın. Daha hızlı yanıtlar için paneli küçük tutun ve daha hızlı analiz ve değerlendirici modelleri seçin. Yapılandırılmış başvuruyu tek seferlik yerel model çağrısıyla test edin: 
openclaw infer model run --local \
  --model openrouter/openrouter/fusion \
  --prompt "Reply with exactly: FUSION_OK" \
  --json

​
Kimlik doğrulama ve üst bilgiler

OpenRouter perde arkasında API anahtarınızla Bearer token kullanır. OpenRouter OAuth, OpenRouter API anahtarı veren bir PKCE oturum açma akışıdır; bu nedenle OpenClaw sonucu manuel API anahtarı kurulum yolunda kullanılan aynı openrouter:default API anahtarı kimlik doğrulama profili olarak saklar. Mevcut bir kurulumda, tam katılımı yeniden çalıştırmadan oturum açın veya saklanan OpenRouter anahtarını döndürün: 
openclaw models auth login --provider openrouter --method oauth
OpenRouter’da elle oluşturduğunuz bir anahtarı yapıştırmak istediğinizde openclaw models auth login --provider openrouter --method api-key kullanın. Gerçek OpenRouter isteklerinde (https://openrouter.ai/api/v1) OpenClaw ayrıca OpenRouter’ın belgelenmiş uygulama ilişkilendirme üst bilgilerini ekler:
Üst bilgiDeğer
HTTP-Refererhttps://openclaw.ai
X-OpenRouter-TitleOpenClaw
X-OpenRouter-Categoriescli-agent,cloud-agent,programming-app,creative-writing,writing-assistant,general-chat,personal-agent
OpenRouter sağlayıcısını başka bir proxy veya temel URL’ye yönlendirirseniz OpenClaw, OpenRouter’a özgü bu üst bilgileri veya Anthropic önbellek işaretleyicilerini eklemez.

​
Gelişmiş yapılandırma

OpenRouter yanıt önbelleğe alma isteğe bağlıdır. Bunu her OpenRouter modeli için model parametreleriyle etkinleştirin:
{
  agents: {
    defaults: {
      models: {
        "openrouter/auto": {
          params: {
            responseCache: true,
            responseCacheTtlSeconds: 300,
          },
        },
      },
    },
  },
}
OpenClaw X-OpenRouter-Cache: true ve yapılandırıldığında X-OpenRouter-Cache-TTL gönderir. responseCacheClear: true, geçerli istek için yenilemeyi zorlar ve yerine geçen yanıtı saklar. Snake_case takma adları (response_cache, response_cache_ttl_seconds ve response_cache_clear) da kabul edilir.Bu, sağlayıcı istem önbelleğe alma işleminden ve OpenRouter’ın Anthropic cache_control işaretleyicilerinden ayrıdır. Özel proxy temel URL’lerinde değil, yalnızca doğrulanmış openrouter.ai rotalarında uygulanır.
Doğrulanmış OpenRouter rotalarında, Anthropic model başvuruları OpenClaw’ın sistem/geliştirici istem bloklarında daha iyi istem önbelleği yeniden kullanımı için kullandığı OpenRouter’a özgü Anthropic cache_control işaretleyicilerini korur.
Doğrulanmış OpenRouter rotalarında, akıl yürütme etkinleştirilmiş Anthropic model referansları, istek OpenRouter’a ulaşmadan önce sondaki assistant ön doldurma dönüşlerini kaldırır; bu, Anthropic’in akıl yürütme konuşmalarının bir user dönüşüyle bitmesi gereksinimiyle eşleşir.
Desteklenen auto olmayan rotalarda OpenClaw, seçilen thinking düzeyini OpenRouter proxy akıl yürütme yüklerine eşler. Desteklenmeyen model ipuçları ve openrouter/auto bu akıl yürütme enjeksiyonunu atlar. Hunter Alpha da, eskimiş yapılandırılmış model referansları için proxy akıl yürütmesini atlar; çünkü OpenRouter bu emekli rota için akıl yürütme alanlarında nihai yanıt metni döndürebilir.
Doğrulanmış OpenRouter rotalarında, openrouter/deepseek/deepseek-v4-flash ve openrouter/deepseek/deepseek-v4-pro, yeniden oynatılan assistant dönüşlerinde eksik reasoning_content alanını doldurur; böylece thinking/araç konuşmaları DeepSeek V4’ün gerekli takip biçimini korur. OpenClaw bu rotalar için OpenRouter tarafından desteklenen reasoning.effort değerlerini gönderir; daha düşük, kapalı olmayan düzeyler high değerine eşlenir ve eskimiş max geçersiz kılmaları xhigh değerine eşlenir.
OpenRouter hâlâ proxy tarzı OpenAI uyumlu yoldan çalışır; bu nedenle serviceTier, Responses store, OpenAI akıl yürütme uyumluluk yükleri ve istem önbelleği ipuçları gibi yerel, yalnızca OpenAI’ye özgü istek biçimlendirmeleri iletilmez.
Gemini destekli OpenRouter referansları proxy-Gemini yolunda kalır: OpenClaw burada Gemini düşünce imzası temizliğini korur, ancak yerel Gemini yeniden oynatma doğrulamasını veya önyükleme yeniden yazımlarını etkinleştirmez.
OpenRouter, alttaki sağlayıcı yönlendirmesi için bir provider istek nesnesini destekler. Tüm OpenRouter metin modeli istekleri için varsayılan bir ilkeyi models.providers.openrouter.params.provider ile yapılandırın:
{
  models: {
    providers: {
      openrouter: {
        params: {
          provider: {
            sort: "latency",
            require_parameters: true,
            data_collection: "deny",
          },
        },
      },
    },
  },
}
OpenClaw bu nesneyi OpenRouter’a istek provider yükü olarak iletir. sort, only, ignore, order, allow_fallbacks, require_parameters, data_collection, quantizations, max_price, preferred_max_latency, preferred_min_throughput, zdr ve enforce_distillable_text dahil olmak üzere OpenRouter’ın belgelenmiş snake_case alanlarını kullanın.Model başına parametreler, sağlayıcı genelindeki yönlendirme nesnesini yine de geçersiz kılar:
{
  agents: {
    defaults: {
      models: {
        "openrouter/anthropic/claude-sonnet-4-6": {
          params: {
            provider: {
              order: ["anthropic"],
              allow_fallbacks: false,
            },
          },
        },
      },
    },
  },
}
Bu yalnızca OpenRouter chat-completions rotalarında geçerlidir. Doğrudan Anthropic, Google, OpenAI veya özel sağlayıcı rotaları OpenRouter yönlendirme parametrelerini yok sayar.

​
İlgili

Model seçimi

Sağlayıcıları, model referanslarını ve yük devretme davranışını seçme.

Yapılandırma başvurusu

Ajanlar, modeller ve sağlayıcılar için tam yapılandırma başvurusu.