Wiederholungsrichtlinie

Ziele

• Wiederholungsversuche pro HTTP-Anfrage, nicht pro mehrstufigem Ablauf.
• Reihenfolge beibehalten, indem nur der aktuelle Schritt erneut versucht wird.
• Duplizierung nicht idempotenter Vorgänge vermeiden.

Standardwerte

Verhalten

Modell-Provider

• OpenClaw überlässt die üblichen kurzen Wiederholungsversuche den Provider-SDKs.
• Bei Stainless-basierten SDKs wie Anthropic und OpenAI können wiederholbare Antworten (408, 409, 429 und 5xx) retry-after-ms oder retry-after enthalten. Wenn diese Wartezeit länger als 60 Sekunden ist, fügt OpenClaw x-should-retry: false ein, damit das SDK den Fehler sofort weitergibt und der Modell-Failover zu einem anderen Authentifizierungsprofil oder Fallback-Modell wechseln kann.
• Überschreiben Sie die Obergrenze mit OPENCLAW_SDK_RETRY_MAX_WAIT_SECONDS=<seconds>. Setzen Sie den Wert auf 0, false, off, none oder disabled, damit SDKs lange Retry-After-Wartezeiten intern berücksichtigen.

Discord

• Wiederholungsversuche erfolgen bei Ratenbegrenzungsfehlern (HTTP 429), Anfragezeitüberschreitungen, HTTP-5xx-Antworten und vorübergehenden Transportfehlern wie DNS-Auflösungsfehlern, Verbindungsabbrüchen, geschlossenen Sockets und Abruffehlern.
• Verwendet Discords retry_after, sofern verfügbar, andernfalls exponentiellen Backoff.

Telegram

• Wiederholungsversuche erfolgen bei vorübergehenden Fehlern (429, Zeitüberschreitung, Verbindungsaufbau/-abbruch/-schließung, vorübergehend nicht verfügbar).
• Verwendet retry_after, sofern verfügbar, andernfalls exponentiellen Backoff.
• HTML-/Markdown-Parsingfehler werden nicht erneut versucht; beim ersten Versuch wird auf Klartext zurückgegriffen.

Konfiguration

Legen Sie die Wiederholungsrichtlinie pro Provider in ~/.openclaw/openclaw.json fest:

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

Hinweise

• Wiederholungsversuche gelten pro Anfrage (Nachricht senden, Medien hochladen, Reaktion, Umfrage, Sticker).
• Zusammengesetzte Abläufe wiederholen keine bereits abgeschlossenen Schritte.

Verwandte Themen

• Modell-Failover
• Befehlswarteschlange