Kebijakan percobaan ulang

Tujuan

• Mencoba ulang per permintaan HTTP, bukan per alur multilangkah.
• Mempertahankan urutan dengan hanya mencoba ulang langkah saat ini.
• Menghindari duplikasi operasi yang tidak idempoten.

Bawaan

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 tersebut lebih dari 60 detik, OpenClaw menyisipkan x-should-retry: false agar SDK segera memunculkan galat dan failover model dapat beralih ke profil autentikasi lain atau model cadangan.
• Ganti batas tersebut dengan OPENCLAW_SDK_RETRY_MAX_WAIT_SECONDS=<seconds>. Atur ke 0, false, off, none, atau disabled agar SDK menangani waktu tunggu Retry-After yang panjang secara internal.

Discord

• Mencoba ulang saat terjadi galat batas laju (HTTP 429), batas waktu permintaan, respons HTTP 5xx, dan kegagalan transportasi sementara seperti kegagalan pencarian DNS, pengaturan ulang koneksi, penutupan soket, dan kegagalan pengambilan.
• Menggunakan retry_after Discord jika tersedia; jika tidak, menggunakan backoff eksponensial.

Telegram

• Mencoba ulang saat terjadi galat sementara (429, batas waktu, koneksi/pengaturan ulang/penutupan, tidak tersedia untuk sementara).
• Menggunakan retry_after jika tersedia; jika tidak, menggunakan backoff eksponensial.
• Galat penguraian HTML/Markdown tidak dicoba ulang; pada percobaan pertama, sistem beralih 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, pengunggahan media, reaksi, jajak pendapat, stiker).
• Alur gabungan tidak mencoba ulang langkah yang telah selesai.

Terkait

• Failover model
• Antrean perintah