Yeniden deneme ilkesi

# Hedefler

• Çok adımlı akış başına değil, HTTP isteği başına yeniden deneyin.
• Yalnızca geçerli adımı yeniden deneyerek sıralamayı koruyun.
• İdempotent olmayan işlemleri çoğaltmaktan kaçının.

# Varsayılanlar

• Deneme sayısı: 3
• Maksimum gecikme sınırı: 30000 ms
• Jitter: 0.1 (yüzde 10)
• Sağlayıcı varsayılanları:
  • Telegram minimum gecikme: 400 ms
  • Discord minimum gecikme: 500 ms

# Davranış

# Model sağlayıcıları

• OpenClaw, sağlayıcı SDK'lerinin normal kısa yeniden denemeleri işlemesine izin verir.
• Anthropic ve OpenAI gibi Stainless tabanlı SDK'ler için, yeniden denenebilir yanıtlar (408, 409, 429 ve 5xx) retry-after-ms veya retry-after içerebilir. Bu bekleme 60 saniyeden uzun olduğunda OpenClaw, SDK'nin hatayı hemen göstermesi ve model yük devretmesinin başka bir kimlik doğrulama profiline veya yedek modele dönebilmesi için x-should-retry: false ekler.
• Sınırı OPENCLAW_SDK_RETRY_MAX_WAIT_SECONDS=<seconds> ile geçersiz kılın. SDK'lerin uzun Retry-After beklemelerini dahili olarak uygulamasına izin vermek için bunu 0, false, off, none veya disabled olarak ayarlayın.

# Discord

• Hız sınırı hatalarında (HTTP 429), istek zaman aşımlarında, HTTP 5xx yanıtlarında ve DNS arama hataları, bağlantı sıfırlamaları, soket kapanmaları ve fetch hataları gibi geçici aktarım hatalarında yeniden dener.
• Mevcut olduğunda Discord retry_after kullanır, aksi halde üstel geri çekilme uygular.

# Telegram

• Geçici hatalarda (429, zaman aşımı, bağlanma/sıfırlama/kapanma, geçici olarak kullanılamama) yeniden dener.
• Mevcut olduğunda retry_after kullanır, aksi halde üstel geri çekilme uygular.
• Markdown ayrıştırma hataları yeniden denenmez; düz metne geri dönerler.

# Yapılandırma

~/.openclaw/openclaw.json içinde sağlayıcı başına yeniden deneme politikasını ayarlayın:

{
  channels: {
    telegram: {
      retry: {
        attempts: 3,
        minDelayMs: 400,
        maxDelayMs: 30000,
        jitter: 0.1,
      },
    },
    discord: {
      retry: {
        attempts: 3,
        minDelayMs: 500,
        maxDelayMs: 30000,
        jitter: 0.1,
      },
    },
  },
}

# Notlar

• Yeniden denemeler istek başına uygulanır (mesaj gönderme, medya yükleme, tepki, anket, çıkartma).
• Bileşik akışlar tamamlanan adımları yeniden denemez.

# İlgili

• Model yük devretmesi
• Komut kuyruğu