重試政策

# 目標

• 依每個 HTTP 請求重試，而不是依多步驟流程重試。
• 只重試目前步驟，以保留順序。
• 避免重複執行非冪等操作。

# 預設值

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

# 行為

# 模型供應商

• OpenClaw 讓供應商 SDK 處理一般的短暫重試。
• 對於以 Stainless 為基礎的 SDK，例如 Anthropic 和 OpenAI，可重試的回應 (408, 409, 429, and 5xx) 可以包含 retry-after-ms 或 retry-after。當該等待時間超過 60 秒時，OpenClaw 會注入 x-should-retry: false，讓 SDK 立即呈現錯誤，且模型 容錯移轉可以輪替到另一個驗證設定檔或備援模型。
• 使用 OPENCLAW_SDK_RETRY_MAX_WAIT_SECONDS=<seconds> 覆寫上限。 將其設為 0, false, off, none, 或 disabled，即可讓 SDK 在內部遵循較長的 Retry-After 休眠。

# Discord

• 會針對速率限制錯誤（HTTP 429）、請求逾時、HTTP 5xx 回應， 以及暫時性傳輸失敗（例如 DNS 查詢失敗、連線 重設、socket 關閉和 fetch 失敗）重試。
• 有 Discord retry_after 時使用它，否則使用指數退避。

# Telegram

• 會針對暫時性錯誤（429、逾時、connect/reset/closed、暫時無法使用）重試。
• 有 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,
      },
    },
  },
}

# 注意事項

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

# 相關

• 模型容錯移轉
• 命令佇列