Retry policy

기준일: 2026-07-26
공식 기준: Retry policy

Retry policy 문서는 OpenClaw 공식 문서(concepts/retry)를 한국어로 정리한 가이드입니다. Retry policy for outbound provider calls 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Retry policy for outbound provider calls

한국어 가이드 범위: concepts/retry 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• Goals
• Defaults
• 동작
• Model providers
• Discord
• Telegram
• 구성
• 참고
• 관련 문서

상세 내용

Goals

주요 항목:

• Retry per HTTP request, not per multi-step flow.
• Preserve ordering by retrying only the current step.
• Avoid duplicating non-idempotent operations.

Defaults

Setting	Default
Attempts	3
Max delay cap	30000 ms
Jitter	0.1 (10%)
Telegram min delay	400 ms
Discord min delay	500 ms

동작

이 섹션의 세부 항목은 공식 문서 동작를 참고하세요.

Model providers

주요 항목:

• OpenClaw lets provider SDKs handle normal short retries.
• For Stainless-based SDKs such as Anthropic and OpenAI, retryable responses (408, 409, 429, and 5xx) can include retry-after-ms or retry-after. When that wait is longer than 60 seconds, OpenClaw injects x-should-retry: false so the SDK surfaces the error immediately and model failover can rotate to another auth profile or fallback model.
• Override the cap with OPENCLAW_SDK_RETRY_MAX_WAIT_SECONDS=<seconds>. Set it to 0, false, off, none, or disabled to let SDKs honor long Retry-After sleeps internally.

Discord

주요 항목:

• Retries on rate-limit errors (HTTP 429), request timeouts, HTTP 5xx responses, and transient transport failures such as DNS lookup failures, connection resets, socket closes, and fetch failures.
• Uses Discord retry_after when available, otherwise exponential backoff.

Telegram

주요 항목:

• Retries on transient errors (429, timeout, connect/reset/closed, temporarily unavailable).
• Uses retry_after when available, otherwise exponential backoff.
• HTML/Markdown parse errors are not retried; they fall back to plain text on the first attempt.

구성

Set retry policy per provider in ~/.openclaw/openclaw.json:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

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

참고

주요 항목:

• Retries apply per request (message send, media upload, reaction, poll, sticker).
• Composite flows do not retry completed steps.

관련 문서

주요 항목:

• Model failover
• Command queue

실습 체크리스트

1. 공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/concepts/retry
2. 관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
3. 설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
4. Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

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

관련 링크

• 공식 원문: concepts/retry
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.