--- read_when: - Birden fazla model sağlayıcısı için tek bir yönetilen anahtar istiyorsunuz - OpenClaw'da ClawRouter model keşfine veya kota raporlamasına ihtiyacınız var summary: Kimlik bilgisi kapsamlı modelleri ClawRouter üzerinden yönlendirin ve yönetilen kotaları gösterin title: ClawRouter x-i18n: generated_at: "2026-07-27T00:12:14Z" model: gpt-5.6 postprocess_version: locale-links-v1 prompt_version: 32 provider: openai source_hash: 929a93e8d1d003e21f792d0fdab9542553ffab374f59d4d0505819b0f719591f source_path: providers/clawrouter.md workflow: 16 --- ClawRouter, OpenClaw'a birden fazla üst model sağlayıcısı için politika kapsamlı tek bir anahtar sağlar. Paketle birlikte gelen `clawrouter` Plugin'i yalnızca bu anahtar için izin verilen modelleri keşfeder, her modeli bildirilen protokolü üzerinden yönlendirir ve anahtarın bütçesiyle toplam kullanımını OpenClaw kullanım yüzeylerinde bildirir. Üst kimlik bilgileri ve sağlayıcıya özgü yönlendirme ClawRouter'da kalır; böylece OpenClaw ana makinesinde her üst sağlayıcı Plugin'ini yüklemeniz veya her biri için kimlik doğrulaması yapmanız gerekmez. Plugin, OpenClaw ile paketlenmiş olarak gelir (`enabledByDefault: true`); yalnızca verilmiş bir ClawRouter kimlik bilgisine ihtiyacınız vardır. | Özellik | Değer | | ------------- | ---------------------------------------- | | Sağlayıcı | `clawrouter` | | Plugin | paketle birlikte gelir (OpenClaw'a dahildir) | | Kimlik doğrulama | `CLAWROUTER_API_KEY` | | Varsayılan URL | `https://clawrouter.openclaw.ai` | | Model kataloğu | `/v1/catalog` aracılığıyla kimlik bilgisi kapsamlı | | Kotalar | `/v1/usage` aracılığıyla aylık bütçe ve kullanım | ## Başlarken ClawRouter yöneticinizden, kullanmanız gereken sağlayıcıları, modelleri ve aylık bütçeyi politikası kapsamında bulunduran bir kimlik bilgisi isteyin. Kimlik bilgileri verildiğinde yalnızca bir kez gösterilir. ```bash export CLAWROUTER_API_KEY="..." openclaw onboard --auth-choice clawrouter-api-key openclaw plugins enable clawrouter ``` `clawrouter` paketle birlikte gelir ve varsayılan olarak etkindir. Yapılandırmanız `plugins.allow` değerini ayarlıyorsa etkinleştirmeden önce bu listeye `clawrouter` ekleyin. Özel bir dağıtım için `models.providers.clawrouter.baseUrl` değerini ClawRouter kaynağına ayarlayın; varsayılan değer `https://clawrouter.openclaw.ai` şeklindedir. ```bash openclaw models list --all --provider clawrouter ``` Döndürülen model referanslarını tam olarak gösterildiği gibi kullanın. Bunlar `clawrouter/openai/gpt-5.5`, `clawrouter/anthropic/claude-sonnet-4-6` veya `clawrouter/google/gemini-3.5-flash` gibi üst ad alanını korur. `agents.defaults.modelPolicy.allow` yapılandırılmışsa seçilen her ClawRouter referansını buna ekleyin. ```bash openclaw models set clawrouter// ``` Döndürülen bir modeli tek çalıştırma için `openclaw agent --model clawrouter// --message "..."` ile de seçebilirsiniz. ## Yönetilen etkileşimsiz dağıtım Proxy anahtarını iş yükünün gizli değer enjeksiyonunda tutun ve `openclaw.json` içinde yalnızca bir SecretRef depolayın. Standart yönetilen alanlar şunlardır: | Amaç | Yapılandırma veya ortam alanı | | ------------- | ------------------------------------------------------------------------ | | Yönlendirici kaynağı | `models.providers.clawrouter.baseUrl` | | Kimlik bilgisi | `models.providers.clawrouter.apiKey` -> ortam SecretRef'i | | Gizli değer | Gateway işlem ortamında `CLAWROUTER_API_KEY` | | Varsayılan model | `agents.defaults.model.primary` -> `clawrouter//` | | İş yükü etiketi | `models.providers.clawrouter.headers.X-ClawRouter-Project-Id` (isteğe bağlı) | Örneğin bir dağıtım denetleyicisi şu JSON5 yamasının sahibi olabilir: ```json5 { plugins: { entries: { clawrouter: { enabled: true } }, }, models: { providers: { clawrouter: { baseUrl: "https://clawrouter.internal.example", apiKey: { source: "env", provider: "default", id: "CLAWROUTER_API_KEY", }, headers: { "X-ClawRouter-Project-Id": "fakeco", }, }, }, }, agents: { defaults: { model: { primary: "clawrouter/openai/gpt-5.5" }, }, }, } ``` Dağıtım `plugins.allow` değerini ayarlıyorsa mevcut girdilerini koruyun ve `clawrouter` ekleyin. Etkileşimli sihirbaz olmadan doğrulayıp uygulayın: ```bash openclaw config patch --file ./clawrouter.patch.json5 --dry-run --json openclaw config patch --file ./clawrouter.patch.json5 ``` Deneme çalıştırması SecretRef'i çözümler ancak değerini hiçbir zaman yazdırmaz. Kimlik bilgisini döndürmek için `CLAWROUTER_API_KEY` sağlayan harici Secret'ı güncelleyin ve yeni işlem ortamının yüklenmesi için Gateway iş yükünü yeniden başlatın. Yapılandırma dosyası ve model referansı değişmez. Kaynaktan derlenen bağımsız bir Docker Gateway'i için ClawRouter zaten kök çalışma zamanına dahildir. Yalnızca `OPENCLAW_EXTENSIONS=clickclack`, `slack` veya `msteams` gibi ayrı paketleme gerektiren kanal Plugin'ini seçin; [kaynaktan derlenen, seçili Plugin'leri içeren imajlar](/tr/install/docker#source-built-images-with-selected-plugins) bölümüne bakın. Arşiv/cihaz dağıtımları, OCI imajını kullanmak yerine aynı birleştirilmiş kaynağı kendi yapıt işlem hatları üzerinden paketlemelidir. ## Hazır olma durumu ve canlı kanıt Bu denetimler farklı sınırları kanıtlar; birini diğerinin yerine kullanmayın: ```bash # Yalnızca ClawRouter işlem sağlığı; hiçbir kimlik bilgisi veya üst model sınanmaz. curl -fsS https://clawrouter.internal.example/v1/health # Yalnızca OpenClaw Gateway başlatma hazırlığı; model çağrısı yapılmaz. curl -fsS http://127.0.0.1:18789/readyz # Kimlik bilgisi kapsamlı katalog keşfi. openclaw models list --all --provider clawrouter --json # Yapılandırılmış ClawRouter sağlayıcısı üzerinden minimum gerçek çıkarım yoklaması. openclaw models status --probe --probe-provider clawrouter --probe-max-tokens 8 --json # Tam bir izin verilen model referansını kullanan iş yükü kanaryası. openclaw agent --agent main \ --model clawrouter/openai/gpt-5.5 \ --message "Tam olarak şu yanıtı verin: CLAWROUTER_CANARY_OK" \ --json ``` Örnek modeli körü körüne kopyalamak yerine kapsamlı katalog tarafından döndürülen bir modeli kullanın. Başarılı bir `/readyz` yanıtı, Gateway'in isteklere hizmet verebildiği anlamına gelir; ClawRouter'ın, kimlik bilgisinin veya bir üst sağlayıcının hazır olduğunu göstermez. Model yoklaması ve aracı kanaryası çıkarım kanıtlarıdır. Canlı tanılama için kanaryayı çalıştırın ve Gateway'in standart günlüklerini inceleyin. Mevcut, yalnızca meta veri içeren model aktarımı tanılamaları şu biçimde satırlar üretir: ```text [model-fetch] başlangıç provider=clawrouter api=openai-responses model=openai/gpt-5.5 method=POST url=https://clawrouter.internal.example/v1/responses [model-fetch] yanıt provider=clawrouter api=openai-responses model=openai/gpt-5.5 status=200 ``` Plugin, bu tanımlayıcılar kullanılabilir olduğunda sınırlı `X-ClawRouter-Client`, `X-ClawRouter-Agent-Id` ve `X-ClawRouter-Session-Id` üstbilgilerini gönderir. Ayrıca model çağrısının tanılama `callId` değerini (`:model:`) `X-Request-ID` ile eşler; böylece bir OpenClaw model çağrısı olayı, ClawRouter'ın yalnızca meta veri içeren denetim iziyle birleştirilebilir. 128 karakterlik istek kimliği bütçesi içindeki değerler aynıdır. Daha uzun değerler `:model:` son ekini ve deterministik bir karmayı korur; böylece farklı çağrılar sınırlı ve birleştirilebilir kalır. `X-ClawRouter-Project-Id` gibi statik dağıtım meta verileri sağlayıcının `headers` eşlemesinde ayarlanabilir. Aracı ve oturum ilişkilendirme üstbilgileri ayrı 256 karakterlik sınırlarını korur. ClawRouter'ın ASCII tanımlayıcı kümesi dışındaki karakterleri içeren otomatik istek kimlikleri aynı deterministik sınırlı biçimi kullanır. `X-Request-ID` değerinin herhangi bir büyük/küçük harf çeşidi dahil olmak üzere açıkça yapılandırılmış üstbilgiler otomatik değerlere göre önceliklidir. Aktarım tanılaması yönlendirme ve yanıt meta verilerini kaydeder; kimlik bilgilerini, istek kimliklerini, istemleri veya tamamlamaları günlüğe kaydetmez. ClawRouter'ın kendi denetim olayı, seçilen üst sağlayıcıyı ve içerik saklama durumunu sağlar. ## Model keşfi `GET /v1/catalog`, `{ providers: [...] }` döndürür; burada her sağlayıcı girdisi kendi `models[]` listesini (üst kimlik, yetenekler ve fiyatlandırmayla) ve desteklenen istek rotalarını içerir. OpenClaw, ClawRouter modellerinin ikinci bir sabit listesini sunmaz. Bir katalog modeli şu durumlarda OpenClaw modeli olarak duyurulur: - kimlik bilgisinin politikası sağlayıcısına izin veriyorsa; - katalog modeli, eşleşen bir akış rotasıyla desteklenen bir LLM yeteneğini (`llm.responses`, `llm.chat`, `llm.messages` veya `llm.stream`) duyuruyorsa; ve - sağlayıcı aşağıdaki aktarımlardan biri için eşleşen bir rota sunuyorsa. Desteklenen bir ClawRouter sağlayıcısına model eklemek OpenClaw sürümü gerektirmez: bir sonraki katalog yenilemesi (kimlik bilgisi kapsamı başına 60 saniye önbelleğe alınır) modeli keşfeder. Yeni bir kablo protokolü gerektiren model için önce Plugin desteği gerekir. ## Protokol ve sağlayıcı Plugin'leri ClawRouter üst kimlik bilgilerinin sahibidir; kataloğu OpenClaw'a hangi aktarımın kullanılacağını bildirir, böylece her üst şirketin kimlik doğrulama Plugin'ini yüklemeniz gerekmez. | Katalog yeteneği / rotası | OpenClaw aktarımı | | -------------------------------------------------------- | ---------------------- | | `llm.responses` (OpenAI uyumlu sağlayıcı) | `openai-responses` | | `llm.chat` (OpenAI uyumlu sağlayıcı) | `openai-completions` | | `llm.messages` + `anthropic.messages` rotası | `anthropic-messages` | | `llm.stream` + akışlı `google.generate_content` rotası | `google-generative-ai` | Plugin ayrıca bu aileler için eşleşen yeniden oynatma ve araç şeması politikalarını uygular (OpenAI/DeepSeek/Gemini/Perplexity araç şeması uyumluluğu; yerel Anthropic ve Google Gemini yeniden oynatma politikaları). Perplexity modellerine katı bir şema yeniden yazımı uygulanır: `patternProperties` ve `additionalProperties` kaldırılır ve her nesne şeması `properties` değerini bildirir; çünkü Perplexity bunları içermeyen araç şemalarını reddeder. Yalnızca desteklenmeyen bir istek biçimi sunan katalog sağlayıcısı, kasıtlı olarak OpenClaw metin modeli olarak duyurulmaz. Uyumsuz yük göndermek yerine bu sağlayıcıları ClawRouter'daki desteklenen sözleşmelerden birine normalleştirin. ## Kotalar ve kullanım ClawRouter'ın `/v1/usage` yanıtı normal OpenClaw sağlayıcı kullanım yüzeylerini besler: istek, token ve harcama toplamları ile anahtarın sınırı olduğunda aylık bütçe penceresi. Ölçülmeyen anahtarlar da yüzde penceresi olmadan toplam kullanımı gösterir. Kota araması, model keşfiyle aynı kapsamlı anahtarı kullanır. Başarısız bir kota araması model yürütmesini engellemez. Canlı anlık görüntüyü şunlarla denetleyin: ```bash openclaw status --usage openclaw models status ``` Aynı sağlayıcı anlık görüntüsü, sohbette `/status` ve OpenClaw'un kullanım kullanıcı arayüzünde kullanılabilir. Bütçe politika genelindedir; dolayısıyla aynı ClawRouter politikasını kullanan başka bir istemcinin yaptığı istekler kalan yüzdeyi değiştirebilir. ## Sorun giderme | Belirti | Denetim | | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | ClawRouter modeli yok | Plugin'in etkin olduğunu ve `plugins.allow` tarafından izin verildiğini doğrulayın, ardından kimlik bilgisinin etkin olduğunu ve en az bir hazır sağlayıcıya izin verdiğini denetleyin. | | Yapılandırılmış bir ClawRouter modeli eksik | `/v1/catalog` yeteneğini ve rota desteğini inceleyin. Desteklenmeyen aktarım sözleşmeleri kasıtlı olarak filtrelenir. | | Model geçersiz kılması politika tarafından reddedildi | Tam katalog referansını veya `clawrouter/*` değerini `agents.defaults.modelPolicy.allow` öğesine ekleyin. | | Katalogdan veya kullanımdan `401` ya da `403` | ClawRouter kimlik bilgisini yeniden verin veya yeniden kapsamlandırın; OpenClaw üst sağlayıcı anahtarlarına geri dönmez. | | Model çağrısı keşiften sonra başarısız oluyor | ClawRouter'daki sağlayıcı bağlantısını ve üst sistem sağlığını denetleyin, ardından hazır olma durumu düzeldiğinde yeniden deneyin. | | Kullanımda toplamlar var ancak yüzde yok | Politika ölçülmüyor; yüzde penceresini göstermek için ClawRouter'a aylık bütçe ekleyin. | ## Güvenlik davranışı - Katalog keşfi, yapılandırılmış proxy anahtarıyla sınırlandırılır ve kimlik bilgisi kapsamı başına (agent dizini, çalışma alanı dizini, kimlik doğrulama profili kimliği ve temel URL) önbelleğe alınır. - Proxy anahtarı yalnızca istek gönderimi sırasında eklenir; model meta verilerinde saklanmaz. - Otomatik atıf ve istek korelasyonu değerleri, gönderimden önce kırpılır ve kontrol karakterleri içeriyorsa reddedilir. Atıf değerleri 256 karakterle, istek kimlikleri ise 128 karakterle sınırlandırılır. - Model aktarımı tanılama verileri yalnızca meta veri içerir ve proxy anahtarını veya model içeriğini hiçbir zaman içermez. - Yerel Anthropic ve Gemini model kimlikleri, yalnızca gönderim sırasında yukarı akış kimliklerine dönüştürülür. - Desteklenmeyen veya izin verilmemiş katalog satırları güvenli biçimde başarısız olur ve seçilemez. ## İlgili Sağlayıcı yapılandırması ve model seçimi. OpenClaw kullanım ve durum yüzeyleri.