Yeniden deneme politikası

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şlemlerin yinelenmesini önleyin.

Varsayılanlar

Davranış

Model sağlayıcıları

• OpenClaw, normal kısa yeniden denemeleri sağlayıcı SDK'larının işlemesine izin verir.
• Anthropic ve OpenAI gibi Stainless tabanlı SDK'larda 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'nın hatayı hemen göstermesi ve model yük devrinin başka bir kimlik doğrulama profiline veya yedek modele geçebilmesi için x-should-retry: false ekler.
• Sınırı OPENCLAW_SDK_RETRY_MAX_WAIT_SECONDS=<seconds> ile geçersiz kılın. SDK'ların uzun Retry-After beklemelerini kendi içinde 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 getirme hataları gibi geçici aktarım hatalarında yeniden dener.
• Kullanılabilir olduğunda Discord retry_after değerini, aksi takdirde üstel geri çekilmeyi kullanır.

Telegram

• Geçici hatalarda (429, zaman aşımı, bağlantı/sıfırlama/kapanma, geçici olarak kullanılamama) yeniden dener.
• Kullanılabilir olduğunda retry_after değerini, aksi takdirde üstel geri çekilmeyi kullanır.
• HTML/Markdown ayrıştırma hataları yeniden denenmez; ilk denemede düz metne geri dönülür.

Yapılandırma

Yeniden deneme politikasını ~/.openclaw/openclaw.json içinde sağlayıcı başına 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 tamamlanmış adımları yeniden denemez.

İlgili Konular

• Model yük devri
• Komut kuyruğu