重試策略¶

目標¶

• 重試是以每個 HTTP 請求為單位，而不是以多步驟流程為單位。
• 僅重試目前步驟即可保留順序。
• 避免重複執行非冪等作業。

預設值¶

• 嘗試次數：3
• 最大延遲上限：30000 ms
• 抖動：0.1（10％）
• 提供者預設值：
• Telegram 最小延遲：400 ms
• Discord 最小延遲：500 ms

行為¶

Discord¶

• 僅在速率限制錯誤（HTTP 429）時重試。
• 可用時使用 Discord retry_after，否則使用指數退避。

Telegram¶

• 在暫時性錯誤時重試（429、timeout、connect/reset/closed、temporarily unavailable）。
• 可用時使用 retry_after，否則使用指數退避。
• Markdown 解析錯誤不會重試；會回退為純文字。

設定¶

在 ~/.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,
      },
    },
  },
}

注意事項¶

• 重試適用於每個請求（訊息發送、媒體上傳、反應、投票、貼圖）。
• 複合流程不會重試已完成的步驟。