OpenClaw fallback 전환 실패: 12분 타임아웃 해결 2026

AI 대형 모델 활용 가이드

fallback으로 사용할 수 있는 로컬 LLM을 알아보세요. AI 대형 모델 가이드 →

이 글에서 다루는 내용: OpenClaw에서 주 AI 공급자(예: Google Gemini)가 다운됐을 때 설정한 백업 공급자로 자동 전환되지 않고, 오히려 12~23분간 응답이 멈추는 fallback provider 전환 실패 현상의 원인과 세 가지 해결 방법을 설명합니다. GitHub Issues #9300, #32533에서 수백 명이 보고한 실제 버그입니다.

12~23분

평균 타임아웃 시간

2개

fallback provider 전환이란 무엇인가?

OpenClaw는 여러 AI 공급자(Provider)를 설정할 수 있습니다. 주 공급자가 과부하되거나 다운됐을 때 자동으로 백업 공급자로 전환하는 기능이 fallback(폴백)입니다. 예를 들어 평소에는 Google Gemini를 사용하다가 Gemini 서버가 다운되면 자동으로 OpenAI로 전환되는 것입니다.

그러나 2026년에 OpenClaw 사용자들은 이 자동 전환이 작동하지 않는 버그를 광범위하게 경험했습니다. 주 공급자가 다운됐는데 백업으로 전환하지 않고, 다운된 같은 공급자에 계속 재시도하다가 12~23분 후에야 타임아웃 오류를 반환합니다.

# 실제 발생하는 오류 메시지 (GitHub Issue #9300)

Error: All providers failed after retry exhaustion
  Provider 1 (google/gemini-2.0-flash): ECONNRESET after 3 retries
  Provider 2 (google/gemini-1.5-pro): Authentication timeout (743s)
  Provider 3 (openai/gpt-5.3-codex): [NEVER ATTEMPTED]

Expected: fallback to Provider 3
Actual: retried Provider 2 with different auth profiles
         then returned error without trying Provider 3

🔍 버그의 핵심 원인

오류 메시지를 보면 Provider 3(OpenAI)이 설정돼 있는데 시도조차 하지 않았습니다. 이는 OpenClaw의 fallback 로직이 "공급자 전환"이 아니라 "같은 공급자에 다른 인증 프로필로 재시도"하도록 잘못 구현됐기 때문입니다. 특히 Google 공급자에서 인증 오류(401)가 발생하면 다른 Google 프로필로 계속 시도하다 전체 타임아웃에 도달합니다.

내 OpenClaw도 이 버그를 가지고 있는지 진단하기

다음 조건 중 하나라도 해당한다면 fallback 전환 실패 버그가 있는 환경입니다.

여러 AI 공급자를 설정했는데 하나가 다운되면 AI가 응답하지 않음

정상이라면 자동으로 다음 공급자로 전환돼야 합니다.

응답이 12분 이상 멈췄다가 오류 메시지 반환

다운된 공급자에 계속 재시도하다 HTTP 요청 타임아웃(743초)에 도달하는 증상.

openclaw logs에서 "NEVER ATTEMPTED" 공급자가 보임

설정된 백업 공급자가 실제로는 시도되지 않았다는 확실한 증거.

Google Gemini를 주 공급자로 사용 중

Google 공급자의 인증 오류가 이 버그를 특히 자주 유발합니다. (Issue #9300)

# 진단 명령어: 공급자 설정과 로그 확인

# 현재 설정된 공급자 목록 확인
openclaw models list

# 최근 실패 로그 확인
openclaw logs --tail 50 | grep -i "provider\|fallback\|retry\|attempted"

# 각 공급자 상태 확인
openclaw models status --plain

해결법 1: 즉시 수동으로 공급자 전환

지금 당장 AI가 응답하지 않는다면 수동으로 공급자를 전환하세요. 자동 fallback이 작동하지 않을 때 가장 빠른 방법입니다.

# 즉시 다른 공급자로 수동 전환

# 1. 현재 모델 상태 확인
openclaw models status --plain

# 2. 다른 공급자로 즉시 전환
openclaw models set openai-codex/gpt-5.3-codex
# 또는
openclaw models set anthropic/claude-sonnet-4
# 또는 (로컬 모델이 설정된 경우)
openclaw models set ollama/qwen3:14b

# 3. 게이트웨이 재시작
openclaw gateway restart

# 4. 응답 확인
openclaw doctor

✅ 수동 전환이 안 되는 경우

모델 전환 후에도 응답이 없다면 게이트웨이 자체가 타임아웃 상태에 걸려있을 수 있습니다. 이 경우 게이트웨이를 완전히 재시작하세요:

openclaw gateway stop
sleep 3
openclaw gateway start
openclaw gateway probe    # "RPC probe: ok" 확인

해결법 2: fallback 타임아웃 설정 단축하기

기본적으로 OpenClaw는 하나의 공급자에서 응답을 기다리는 시간이 너무 깁니다(최대 743초). 이 값을 단축하면 공급자 장애 시 더 빨리 다음 공급자로 넘어갑니다.

# openclaw.json - 공급자 타임아웃 설정 (수동 편집)

{
  "providers": {
    "fallback": {
      "enabled": true,
      "retries": 2,
      "timeout_per_provider": 30,  // 기본 743초 → 30초로 단축
      "skip_on_errors": [
        "ECONNRESET",
        "ETIMEDOUT",
        "401",
        "503",
        "overloaded"
      ]
    }
  }
}

⚠️ 설정 파일 편집 주의사항

openclaw.json을 편집할 때는 반드시 먼저 백업을 만드세요. JSON 형식 오류가 있으면 OpenClaw가 아예 시작되지 않습니다:

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak
nano ~/.openclaw/openclaw.json
# 편집 후 JSON 유효성 확인
python3 -m json.tool ~/.openclaw/openclaw.json

설정 변경 후 적용 방법:

openclaw config validate    # 설정 파일 유효성 검사
openclaw gateway restart    # 새 설정 적용
openclaw doctor             # 전체 상태 확인

해결법 3: 공급자 우선순위를 올바르게 재구성

Google Gemini를 주 공급자로 쓰면서 Google의 다른 프로필을 백업으로 설정하는 것은 이 버그를 더 자주 유발합니다. 서로 다른 회사의 공급자를 조합하는 것이 올바른 fallback 설계입니다.

잘못된 fallback 구성

1순위 Google Gemini Pro

2순위 Google Gemini Flash

3순위 Google Gemini 1.5

모두 Google 서버에 의존. Google 전체 장애 시 모두 실패.

올바른 fallback 구성

1순위 OpenAI GPT-5.3-Codex

2순위 Anthropic Claude Sonnet

3순위 Ollama Qwen3:14b (로컬)

각각 독립 서버. 하나가 다운돼도 나머지 작동.

# 올바른 다중 공급자 설정 (openclaw.json)

{
  "models": {
    "primary": "openai-codex/gpt-5.3-codex",
    "fallbacks": [
      "anthropic/claude-sonnet-4",
      "ollama/qwen3:14b"
    ]
  }
}

Google 공급자 인증 오류가 타임아웃을 유발하는 이유

GitHub Issue #9300 분석에 따르면, Google 공급자는 인증 실패(401) 시 즉각 오류를 반환하지 않고 여러 인증 프로필을 순서대로 시도합니다. OpenClaw가 이를 "아직 응답 기다리는 중"으로 인식해 fallback을 발동하지 않습니다.