重试策略

目标

• 按 HTTP 请求重试，而非按多步流程。
• 仅重试当前步骤以保持顺序。
• 避免重复非幂等操作。

默认

• 尝试次数：3
• 最大延迟上限：30000 毫秒
• 抖动：0.1（10%）
• 提供商默认：Telegram 最小延迟 400 毫秒；Discord 最小延迟 500 毫秒

行为

Discord

• 仅在速率限制错误（HTTP 429）时重试。
• 可用时使用 Discord retry_after，否则指数退避。

Telegram

• 在临时错误（429、timeout、connect/reset/closed、temporarily unavailable）时重试。
• 可用时使用 retry_after，否则指数退避。
• Markdown 解析错误不重试；回退到纯文本。

配置

在 ~/.clawdbot/moltbot.json 中按提供商设置重试策略：

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

说明

• 重试按请求应用（消息发送、媒体上传、反应、投票、贴纸）。
• 复合流程不重试已完成步骤。