> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 重試策略

# 重試策略

## 目標

* 重試是以每個 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` 中為每個提供者設定重試策略：

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    telegram: {
      retry: {
        attempts: 3,
        minDelayMs: 400,
        maxDelayMs: 30000,
        jitter: 0.1,
      },
    },
    discord: {
      retry: {
        attempts: 3,
        minDelayMs: 500,
        maxDelayMs: 30000,
        jitter: 0.1,
      },
    },
  },
}
```

## 注意事項

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