Ana içeriğe atla
ClawRouter, OpenClaw’a birden fazla yukarı akış model sağlayıcısı için ilke kapsamlı tek bir anahtar verir. Paketle gelen Plugin yalnızca bu anahtar için izin verilen modelleri keşfeder, her modeli bildirilen protokolü üzerinden yönlendirir ve anahtarın bütçesini ve toplam kullanımını OpenClaw kullanım yüzeylerinde raporlar. OpenClaw ana makinesinde her yukarı akış sağlayıcı Plugin’ini kurmanız veya kimliğini doğrulamanız gerekmez. Yukarı akış kimlik bilgileri ve sağlayıcıya özgü iletme ClawRouter’da kalır. OpenClaw yalnızca paketle gelen @openclaw/clawrouter Plugin’ine ve verilmiş bir ClawRouter kimlik bilgisine ihtiyaç duyar.
ÖzellikDeğer
Sağlayıcıclawrouter
Paket@openclaw/clawrouter
Kimlik DoğrulamaCLAWROUTER_API_KEY
Varsayılan URLhttps://clawrouter.openclaw.ai
Model kataloğu/v1/catalog üzerinden kimlik bilgisi kapsamlı
Kotalar/v1/usage üzerinden aylık bütçe ve kullanım

​
Başlarken

1

Get a scoped credential

ClawRouter yöneticinizden, kullanmanız gereken sağlayıcıları, modelleri ve aylık bütçeyi içeren ilkeye sahip bir kimlik bilgisi isteyin. Kimlik bilgileri verildiğinde yalnızca bir kez gösterilir.
2

Configure OpenClaw

export CLAWROUTER_API_KEY="..."
openclaw onboard --auth-choice clawrouter-api-key
openclaw plugins enable clawrouter
Plugin, OpenClaw ile paketlenmiş olarak gelir. Yapılandırmanız plugins.allow 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 https://clawrouter.openclaw.ai değeridir.
3

List granted models

openclaw models list --all --provider clawrouter
Döndürülen model başvurularını tam olarak gösterildiği gibi kullanın. clawrouter/openai/..., clawrouter/anthropic/... veya clawrouter/google/... gibi yukarı akış ad alanını korurlar. Yapılandırmanızda agents.defaults.models bir izin listesi ise, seçilen her ClawRouter başvurusunu buna ekleyin.
4

Select a model

openclaw models set clawrouter/<provider>/<model>
Döndürülen bir modeli tek bir çalıştırma için openclaw agent --model clawrouter/<provider>/<model> --message "..." ile de seçebilirsiniz.

​
Model keşfi

GET /v1/catalog doğruluk kaynağıdır. OpenClaw, ClawRouter modellerinin ikinci ve sabit bir listesini göndermez. ClawRouter’da yapılandırılmış bir model şu durumlarda görünür:
  • kimlik bilgisinin ilkesi sağlayıcısını verir;
  • sağlayıcı bağlantısı etkin ve hazırdır;
  • katalog modeli desteklenen bir LLM yeteneği duyurur; ve
  • katalog, Plugin tarafından desteklenen bir aktarım sözleşmesi sunar.
Bu nedenle desteklenen bir ClawRouter sağlayıcısına başka bir model eklemek için OpenClaw sürümü veya başka bir sağlayıcı Plugin’i gerekmez. Sonraki katalog yenilemesi onu keşfeder. Yeni bir tel protokolüne ihtiyaç duyan bir modelin, OpenClaw tarafından duyurulmadan önce ClawRouter Plugin’inde desteklenmesi gerekir.

​
Protokol ve sağlayıcı Plugin’leri

Her yukarı akış şirketinin kimlik doğrulama Plugin’ini kurmanız gerekmez. ClawRouter yukarı akış kimlik bilgilerine sahiptir; kataloğu OpenClaw’a hangi aktarımın kullanılacağını söyler. Plugin şunları destekler:
Katalog rotasıOpenClaw aktarımı
OpenAI uyumlu sohbetopenai-completions
OpenAI uyumlu Responsesopenai-responses
Yerel Anthropic Messagesanthropic-messages
Yerel Google Gemini akışıgoogle-generative-ai
Plugin ayrıca bu aileler için eşleşen tekrar oynatma ve araç şeması ilkelerini uygular. Başka bir istek/akış biçimi kullanan katalog satırları kasıtlı olarak OpenClaw metin modelleri olarak duyurulmaz. Uyumsuz bir yük göndermek yerine bu sağlayıcıları ClawRouter’da 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. /status ve ilgili pano durumu, anahtarın bir sınırı olduğunda aylık bütçe penceresini; ayrıca istek, token ve harcama toplamlarını gösterir. Ölçümlenmeyen anahtarlar yine de 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ütmeyi engellemez. Canlı anlık görüntüyü şununla kontrol edin: 
openclaw status --usage
openclaw models status
Aynı sağlayıcı anlık görüntüsü sohbette /status ve OpenClaw’ın kullanım kullanıcı arayüzü için kullanılabilir. Bütçe ilke geneline aittir, bu nedenle aynı ClawRouter ilkesini kullanan başka bir istemci tarafından yapılan istekler kalan yüzdeyi değiştirebilir.

​
Sorun giderme

BelirtiKontrol
ClawRouter modeli yokPlugin’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ı verdiğini kontrol edin.
Yapılandırılmış bir ClawRouter modeli eksik/v1/catalog yeteneğini ve rota biçimini inceleyin. Desteklenmeyen aktarım sözleşmeleri kasıtlı olarak filtrelenir.
Unknown model: clawrouter/...Bu yapılandırma haritası izin listesi olarak kullanılıyorsa tam katalog başvurusunu agents.defaults.models içine ekleyin.
Katalog veya kullanımdan 401 ya da 403ClawRouter kimlik bilgisini yeniden verin veya yeniden kapsamlandırın; OpenClaw yukarı akış sağlayıcı anahtarlarına geri dönmez.
Model çağrısı keşiften sonra başarısız oluyorClawRouter’da sağlayıcı bağlantısını ve yukarı akış sağlığını kontrol edin, ardından hazırlık durumu düzeldikten sonra yeniden deneyin.
Kullanımda toplamlar var ama yüzde yokİlke ölçümlenmemiştir; yüzde penceresi göstermek için ClawRouter’da aylık bütçe ekleyin.

​
Güvenlik davranışı

  • Katalog keşfi yapılandırılmış proxy anahtarıyla kapsamlandırılır ve anahtar başına önbelleğe alınır.
  • Proxy anahtarı yalnızca istek gönderimi sırasında eklenir; model meta verilerinde saklanmaz.
  • Yerel Anthropic ve Gemini model kimlikleri yalnızca gönderim sırasında yukarı akış kimliklerine yeniden yazılır.
  • Desteklenmeyen veya verilmeyen katalog satırları kapalı biçimde başarısız olur ve seçilebilir değildir.

​
İlgili

Model providers

Sağlayıcı yapılandırması ve model seçimi.

Usage tracking

OpenClaw kullanım ve durum yüzeyleri.