Політика повторних спроб

​

Цілі

• Повторювати спроби для кожного HTTP-запиту, а не для всього багатоетапного процесу.
• Зберігати порядок, повторюючи лише поточний етап.
• Уникати дублювання неідемпотентних операцій.

​

Типові значення

​

Поведінка

​

Постачальники моделей

• OpenClaw дозволяє SDK постачальників обробляти звичайні короткі повторні спроби.
• Для SDK на основі Stainless, як-от Anthropic і OpenAI, відповіді, для яких можна повторити запит (408, 409, 429 і 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, скидання з’єднання, закриття сокета та помилки отримання даних.
• Використовує retry_after Discord, якщо він доступний, інакше — експоненційне збільшення затримки.

​

Telegram

• Повторює спроби в разі тимчасових помилок (429, перевищення часу очікування, помилки підключення, скидання або закриття з’єднання, тимчасова недоступність).
• Використовує retry_after, якщо він доступний, інакше — експоненційне збільшення затримки.
• Спроби не повторюються в разі помилок розбору HTML/Markdown; під час першої спроби натомість використовується звичайний текст.

​

Конфігурація

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

​

Примітки

• Повторні спроби застосовуються до кожного запиту (надсилання повідомлення, завантаження медіафайлу, реакція, опитування, наліпка).
• У складених процесах уже завершені етапи не повторюються.

​

Пов’язані матеріали

• Перемикання моделей
• Черга команд