OpenClaw 재시도와 장애 복구 개요
OpenClaw는 원격 Mac·CI에서 의존성 풀·빌드·테스트를 자동화하는 도구입니다. 네트워크·레지스트리 일시 오류로 풀이 실패하면 작업이 중단됩니다. 재시도 정책을 두면 실패 시 자동 재시도로 장애 자가 복구(self-healing)가 가능합니다.
- 재시도 정책: attempts·minDelay·maxDelay로 제어.
- 의존성 풀 실패: npm·CocoaPods·Homebrew 등에 자동 재시도 적용.
- status·doctor: 상태 점검 및 흔한 오류 진단.
원격 Mac에서 설치 및 최소 설정
원격 Mac(SSH·VNC)에 OpenClaw를 설치한 뒤 최소 설정만 하면 재시도를 쓸 수 있습니다. brew install openclaw 또는 공식 스크립트로 설치하고, ~/.openclaw/config.yaml 또는 프로젝트 openclaw.yaml에 retry.attempts, minDelay, maxDelay를 넣습니다.
재시도 정책(attempts·minDelay·maxDelay) 설정 및 예시
attempts는 최대 재시도 횟수, minDelay·maxDelay는 재시도 전 대기(초)의 하한·상한입니다. 지수 백오프 시 minDelay에서 maxDelay까지 증가합니다.
| 항목 | 설명 | 권장 |
|---|---|---|
| attempts | 최대 재시도 횟수 | 3~5 |
| minDelay | 첫 재시도 전 대기(초) | 2~5 |
| maxDelay | 재시도 간 최대 대기(초) | 30~60 |
retry:
attempts: 5
minDelay: 3
maxDelay: 60
의존성 풀 실패 시 자동 재시도 설정
의존성 풀(npm install·pod install·brew install 등)에 재시도 정책을 적용하려면, 설정에서 해당 작업을 재시도 대상으로 지정합니다. 전역 retry를 두면 모든 실패 가능 단계에 적용되고, step별 retry를 두면 의존성 풀만 재시도할 수 있습니다. 재시도 시 로그에 attempt 2/5 등이 남으니 openclaw logs 또는 CI 로그로 확인하세요.
openclaw status·doctor 점검 및 흔한 오류 대처
openclaw status로 에이전트·작업 상태를 보고, openclaw doctor로 환경·네트워크를 진단합니다. 의존성 풀 실패가 반복되면 doctor 출력으로 미러·프록시·디스크를 점검하세요.
- status "failed"·"retrying": 재시도 중이면 대기 후 재확인; 전부 실패 시 doctor·로그로 원인 확인.
- doctor 네트워크 오류: DNS·방화벽·레지스트리 접근 확인; 필요 시 미러·프록시 설정.
- 디스크 부족: 캐시 정리(
npm cache clean등) 또는 디스크 확장. - 권한 오류: 설정 파일·캐시 디렉터리 쓰기 권한 확인.
재현 가능 단계 요약
- 원격 Mac에 OpenClaw 설치(Homebrew 또는 공식 스크립트).
~/.openclaw/config.yaml또는openclaw.yaml에 retry.attempts·minDelay·maxDelay 설정.- 의존성 풀 단계에 재시도 적용 여부 확인(전역 또는 step별).
- 실패 시나리오에서 재시도 동작 확인 후
openclaw status·doctor로 점검. - 흔한 오류(네트워크·디스크·권한)는 doctor·로그로 해결.