Политика повторных попыток

​

Цели

• Повторять каждый 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, сбросы соединения, закрытия сокета и ошибки получения данных.
• Использует значение Discord retry_after, если оно доступно; в противном случае применяется экспоненциальная задержка.

​

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,
      },
    },
  },
}

​

Примечания

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

​

См. также

• Переключение моделей
• Очередь команд