메인 콘텐츠로 건너뛰기

재시도 정책

목표

  • 멀티 스텝 흐름이 아닌 HTTP 요청당 재시도합니다.
  • 현재 단계만 재시도하여 순서를 유지합니다.
  • 비멱등 작업을 중복 수행하지 않습니다.

기본값

  • 시도 횟수: 3
  • 최대 지연 상한: 30000 ms
  • 지터: 0.1 (10 퍼센트)
  • 프로바이더 기본값:
    • Telegram 최소 지연: 400 ms
    • Discord 최소 지연: 500 ms

동작

Discord

  • 속도 제한 오류(HTTP 429)만 재시도합니다.
  • 가능할 경우 Discord retry_after를 사용하고, 그렇지 않으면 지수 백오프를 사용합니다.

Telegram

  • 일시적인 오류 (429, 타임아웃, 연결/재설정/닫힘, 일시적으로 사용 불가능) 에 대해 재시도합니다.
  • 가능할 경우 retry_after를 사용하고, 그렇지 않으면 지수 백오프를 사용합니다.
  • 마크다운 구문 오류는 재시도하지 않으며 일반 텍스트로 대체됩니다.

구성

~/.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,
      },
    },
  },
}

주의사항

  • 전송 요청 (메시지 전송, 미디어 업로드, 반응, 투표, 스티커) 당 재시도가 적용됩니다.
  • 복합 흐름은 완료된 단계에 대해 재시도하지 않습니다.