OPenClaw는 강력한 데이터 수집 도구이지만, 사용 중 오류가 발생할 수 있습니다. 이 글에서는 가장 흔한 오류 코드를 하나씩 분석하여 문제를 신속히 해결하고 도구를 정상 상태로 되돌리는 방법을 알려드립니다. 기술적 문제로 작업 흐름이 중단되지 않도록 도와드릴게요.
오류 코드 1001: 연결 시간 초과
OPenClaw에서 "1001 Connection Timeout" 메시지가 표시되면, 보통 대상 서버의 응답이 느리거나 네트워크 환경에 제한이 있음을 의미합니다. 먼저 로컬 프록시 설정에서 글로벌 모드가 켜져 있는지 확인하고, VPN을 사용 중이라면 분할 모드로 전환하거나 노드를 변경해보세요.
또한 요청 빈도를 낮추는 것도 좋습니다. OPenClaw 설정 파일에서 max_retries 매개변수를 3으로 조정하고 timeout 값을 30초로 늘려보세요. 문제가 지속되면 대상 소스의 미러 주소를 임시로 변경하여 테스트할 수 있습니다.
오류 코드 2003: SSL 인증서 확인 실패
2003 오류는 대상 웹사이트가 자체 서명되었거나 만료된 SSL 인증서를 사용할 때 자주 발생합니다. OPenClaw는 기본적으로 인증서를 엄격하게 검증하므로, 시작 인수에 --ignore-ssl-errors=true를 추가하여 검증을 건너뛸 수 있습니다. 단, 인증서 검증을 비활성화하면 보안이 낮아지므로 통제된 테스트 환경에서만 사용하는 것이 좋습니다.
더 안전한 방법은 Python 환경의 CA 인증서 번들을 수동으로 업데이트하는 것입니다. pip install --upgrade certifi를 실행한 후 OPenClaw를 다시 시작하세요. 여전히 오류가 발생한다면 시스템 시간이 정확한지 확인하세요. 시간 차이도 인증 실패의 원인이 될 수 있습니다.
오류 코드 3012: 쿠키 만료 또는 누락
이 오류는 OPenClaw가 로그인이 필요한 페이지를 수집할 때 유효한 쿠키를 가지고 있지 않음을 나타냅니다. 해결 방법은 최신 쿠키 정보를 다시 가져오는 것입니다. 먼저 대상 웹사이트에 수동으로 로그인한 후, 브라우저 개발자 도구를 통해 쿠키를 내보내고 OPenClaw의 cookies.json 파일에 붙여넣으세요.
