openclaw/docs/zh-CN/concepts/retry.md

read_when, summary, title, x-i18n

read_when	summary	title	x-i18n
更新提供商重试行为或默认值 调试提供商发送错误或速率限制	出站提供商调用的重试策略	重试策略	generated_at model provider source_hash source_path workflow 2026-02-01T20:23:37Z claude-opus-4-5 pi 55bb261ff567f46ce447be9c0ee0c5b5e6d2776287d7662762656c14108dd607 concepts/retry.md 14

重试策略

目标

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

默认值

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

行为

Discord

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

Telegram

• 在瞬态错误时重试（429、超时、连接/重置/关闭、暂时不可用）。
• 可用时使用 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,
      },
    },
  },
}

注意事项

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