Retry-Policies in OpenClaw konfigurieren

Netzwerkfehler oder Rate-Limits sind der Albtraum jedes Entwicklers. Wenn ein Request abbricht, willst du nicht, dass dein ganzer Workflow abstürzt oder Nachrichten in der falschen Reihenfolge ankommen.

Manuell Retries zu implementieren ist oft fehleranfällig und führt im schlimmsten Fall dazu, dass nicht-idempotente Operationen doppelt ausgeführt werden. OpenClaw löst das direkt auf Request-Ebene.

Was du brauchst

• Eine aktive OpenClaw-Instanz
• Zugriff auf die Konfigurationsdatei ~/.openclaw/openclaw.json

Schnellstart

OpenClaw verwendet standardmäßig 3 Versuche mit einem maximalen Delay von 30.000 ms. Um die Policy für deine Provider anzupassen, folge diesen zwei Schritten:

1. Öffne deine Konfigurationsdatei unter ~/.openclaw/openclaw.json.
2. Füge den retry-Block für Telegram oder Discord hinzu:

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

Funktionsweise

Die Retry-Logik greift pro HTTP-Request (z. B. Nachricht senden, Media-Upload, Reaction). Bei zusammengesetzten Flows werden bereits erfolgreich abgeschlossene Schritte nicht wiederholt.

Discord

• Retries erfolgen ausschließlich bei Rate-Limit-Fehlern (HTTP 429).
• OpenClaw nutzt den retry_after-Wert von Discord, falls vorhanden. Ansonsten wird ein exponential backoff verwendet.

Telegram

• Retries erfolgen bei transienten Fehlern wie HTTP 429, Timeouts oder Verbindungsabbrüchen (connect/reset/closed).
• Falls der Telegram-Server vorübergehend nicht erreichbar ist, wird ebenfalls ein Retry ausgelöst.
• Wie bei Discord wird retry_after bevorzugt verwendet.

Fehlerbehebung

Markdown-Fehler bei Telegram Wenn Telegram einen Markdown-Parse-Fehler meldet, wird kein Retry durchgeführt. Stattdessen nutzt OpenClaw automatisch einen Fallback auf Plain Text, um die Nachricht trotzdem zuzustellen.

Rate-Limits Wenn du ständig in Rate-Limits läufst, prüfe die minDelayMs Werte. Telegram benötigt mindestens 400 ms, Discord mindestens 500 ms.

Hast du Fragen zur Konfiguration? Nutze den AI Setup Assistant.

Wie es weitergeht

• Telegram Provider Details
• Discord Provider Details