重试策略

目标

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

默认值

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

行为

Discord

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

Telegram

  • 在瞬态错误时重试（429、超时、连接/重置/关闭、暂时不可用）。
  • 可用时使用 retry_after，否则使用指数退避。
  • Markdown 解析错误不会重试；会回退为纯文本。

配置

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

  1. {
  2.   channels: {
  3.     telegram: {
  4.       retry: {
  5.         attempts: 3,
  6.         minDelayMs: 400,
  7.         maxDelayMs: 30000,
  8.         jitter: 0.1,
  9.       },
  10.     },
  11.     discord: {
  12.       retry: {
  13.         attempts: 3,
  14.         minDelayMs: 500,
  15.         maxDelayMs: 30000,
  16.         jitter: 0.1,
  17.       },
  18.     },
  19.   },
  20. }

注意事项

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