'Rate Limited — Switching to Fallback' Uyarısı Neden Sürekli Tekrarlanıyor? İşte Derinlemesine Analiz ve Çözüm Rehberi

Bu nedenle, sorunun kökü uyarı mesajında değil, ana modelinizin neden sürekli olarak erişilemez durumda olduğunda yatar.

Neden 'sg claude opus 4.7 via custom' Uyarısını Görüyorum?

Aldığınız uyarıdaki

via custom

En kritik soru şu: Ana modeliniz ve bu özel uç nokta, arka planda aynı API havuzunu, aynı geçidi (gateway) veya aynı API anahtarını mı kullanıyor? Eğer öyleyse, hız sınırına takılan kaynak aslında tek bir noktadır ve siz sadece farklı bir kapıdan aynı kilitli odaya girmeye çalışıyorsunuzdur . Bu, sorunun en olası nedenlerinden biridir.

Sorunu Kökünden Çözmek İçin Kontrol Listesi

Sorunu kalıcı olarak çözmek için aşağıdaki adımları sırayla uygulayarak asıl darboğazı tespit edebilirsiniz.

1. config.yaml Dosyanızı Mercek Altına Alın

Hermes'in kalbi ~/.hermes/config.yaml veya proje dizininizdeki _data/config.yaml dosyasıdır. Bu dosyayı açın ve şunları kontrol edin:

• Ana Model (Primary): Hangi sağlayıcı (provider) ve modeli (model) kullandığınızı not edin.
• Yedek Zinciri (Fallback): fallback_providers veya eski yapılandırmalarda fallback_model altında tanımlı modelleri inceleyin. Özellikle

  provider: custom

  olarak tanımlanmış bir yedeğiniz var mı, kontrol edin .

2. Aynı Havuzdan mı Besleniyorlar?

En önemli kontrol budur. Ana modeliniz ve özel uç noktadaki yedek modeliniz:

• Aynı API anahtarını mı kullanıyor?
• Aynı geçit (örn. OpenClaw Gateway, LiteLLM) arkasındaki aynı modele mi yönleniyor?

Eğer cevabınız 'evet' ise, sorunu buldunuz demektir. Yedek modelinizi, ana modelinizden tamamen farklı bir API anahtarına veya farklı bir sağlayıcıdaki (örneğin OpenRouter) bir modele yönlendirmeniz gerekir .

3. Gateway Durumunu ve Hata Kodlarını Kontrol Edin

Eğer OpenClaw gibi bir geçit kullanıyorsanız, aşağıdaki komutlar gerçek hatayı anlamanıza yardımcı olur:

• openclaw gateway probe

  komutu ile geçidin durumunu ve yeteneklerini kontrol edin .

• openclaw gateway status --deep

  komutu ile eski, takılı kalmış istemci (client) süreçlerini arayın. Bunlar kotanızı tüketiyor olabilir .
• Ham hata mesajını inceleyin. Eğer

  HTTP 429

  hata kodunu görüyorsanız, bu doğrudan bir hız sınırı sorunudur .

4. API Anahtarı ve Ortam Değişkenlerini Doğrulayın

API anahtarlarınızın doğru ve geçerli olduğundan emin olun:

• Anahtarların, geçidin veya Hermes'in çalıştığı makinede (

  gateway host

  ) doğru yerde tanımlandığından emin olun .
• systemd veya launchd ile çalışan bir servis kullanıyorsanız, anahtarları genellikle ~/.openclaw/.env veya ilgili servis dosyasına koymanız ve servisi yeniden başlatmanız gerekir .

5. Uzun Metin (Long Context) İsteklerini Gözden Geçirin

Bazı sağlayıcılar, özellikle çok uzun sohbet geçmişi veya büyük dosyalar içeren isteklerde ek kota talep eder ve reddedebilir. OpenClaw dokümanlarında

HTTP 429: rate_limit_error: Extra usage is required for long context requests

Özet ve Kalıcı Çözüm Yolu

Sürekli fallback uyarısı almanızın nedeni, Hermes'in kendi mekanizmasının kusursuz çalışmasıdır. Asıl mücadele etmeniz gereken şey:

1. Ana modelinizin neden sürekli hız sınırına takıldığını bulmak.
2. Yedek modelinizin, ana modelle aynı kısıtlı kaynağı kullanmadığından emin olmak.

Yapılandırma dosyalarınızı yukarıdaki adımlarla kontrol ederek ve yedek zincirinizi çeşitlendirerek (örneğin ana model için bir API anahtarı, yedek için OpenRouter gibi farklı bir sağlayıcı kullanarak) bu sorunu tamamen ortadan kaldırabilirsiniz .