Kebijakan percobaan ulang

# Tujuan

• Coba ulang per permintaan HTTP, bukan per alur multi-langkah.
• Pertahankan urutan dengan hanya mencoba ulang langkah saat ini.
• Hindari menggandakan operasi yang tidak idempoten.

# Default

• Percobaan: 3
• Batas jeda maksimum: 30000 ms
• Jitter: 0.1 (10 persen)
• Default penyedia:
  • Jeda minimum Telegram: 400 ms
  • Jeda minimum Discord: 500 ms

# Perilaku

# Penyedia model

• OpenClaw membiarkan SDK penyedia menangani percobaan ulang singkat yang normal.
• Untuk SDK berbasis Stainless seperti Anthropic dan OpenAI, respons yang dapat dicoba ulang (408, 409, 429, dan 5xx) dapat menyertakan retry-after-ms atau retry-after. Ketika waktu tunggu itu lebih dari 60 detik, OpenClaw menyisipkan x-should-retry: false agar SDK segera memunculkan kesalahan dan failover model dapat beralih ke profil autentikasi lain atau model fallback.
• Timpa batas dengan OPENCLAW_SDK_RETRY_MAX_WAIT_SECONDS=<seconds>. Atur ke 0, false, off, none, atau disabled agar SDK mematuhi jeda Retry-After yang panjang secara internal.

# Discord

• Mencoba ulang pada kesalahan batas laju (HTTP 429), timeout permintaan, respons HTTP 5xx, dan kegagalan transport sementara seperti kegagalan pencarian DNS, reset koneksi, penutupan socket, dan kegagalan fetch.
• Menggunakan retry_after Discord jika tersedia, jika tidak menggunakan backoff eksponensial.

# Telegram

• Mencoba ulang pada kesalahan sementara (429, timeout, connect/reset/closed, sementara tidak tersedia).
• Menggunakan retry_after jika tersedia, jika tidak menggunakan backoff eksponensial.
• Kesalahan parsing Markdown tidak dicoba ulang; kesalahan tersebut fallback ke teks biasa.

# Konfigurasi

Tetapkan kebijakan percobaan ulang per penyedia di ~/.openclaw/openclaw.json:

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

# Catatan

• Percobaan ulang berlaku per permintaan (pengiriman pesan, unggahan media, reaksi, jajak pendapat, stiker).
• Alur komposit tidak mencoba ulang langkah yang telah selesai.

# Terkait

• Failover model
• Antrean perintah