2026 OpenClaw 프론트 실전:
원격 Mac에서 trace.zip·HAR를 파싱해 최소 재현 요약을 PR로 회수
플래키 E2E는 동일 SHA·동일 trace 규칙이면 재현 가능합니다. trace.zip·트림 HAR로 증거를 고정하고 OpenClaw가 pr_min_repro_summary.md를 채우면 리뷰어는 URL·스텝·실패 요청을 매번 같은 포맷으로 봅니다. 흐름은 보내기→해제·추출→HAR→Markdown→코멘트·Webhook·FAQ입니다. E2E 트리아지, Docker Playwright, 소스맵 PR 요약, Safari Playwright, 시각 회귀 PR와 짝을 맞추세요.
흔한 막힘. ① 러너마다 trace·스크린샷 정책이 달라 비교 불가 ② GUI 뷰어 전제로 헤드리스 추출이 끊김 ③ HAR에 토큰 잔존 ④ 코멘트 중복·429.
01 trace보내기: CI와 Mac이 같은 규칙
use.trace를 팀 표준 한 가지로 고정하세요(on·retain-on-failure·on-first-retry). screenshot·video를 trace와 맞추고 실패 전용이면 푸터에 적어 빈 캡처 추적을 막습니다. 원격 Mac 출력은 .openclaw/reports/<git-sha>/traces/와 값 없는 run_meta.json(저장소·SHA·버전·베이스 URL·인증 방식만)으로 짝지으세요.
trace는 뷰어가 아니라 JSON 추출 입력입니다. 노트북·헤드리스 워커가 같은 스크립트를 돌아야 합니다.
02
trace.zip 해제 후 먼저 읽을 필드
trace.trace에서 스텝·실패 인덱스, 네트워크 레이어에서 URL·상태·지연, 콘솔 오류를 묶어 trace_signals.json으로 정규화합니다. 상위 네트워크 줄은 스무 줄 이하로 자릅니다. URL에서 세션 쿼리를 빼고 localhost 표기를 서비스명으로 통일, 실패 탭만 유지합니다.
storageState·JWT 원문은 JSON에 넣지 말고 메커니즘만 서술하세요.
03 HAR 트림: 버그를 판정할 최소 크기
HAR은 원본 그대로 올리지 말고 아래로 repro.har.trimmed.json을 만듭니다.
| 규칙 | 이유 |
|---|---|
| 테스트 대상 origin·path 접두만 유지 | 리다이렉트·API는 남기고 분석 도메인은 제거합니다. |
Authorization·Cookie·사내 전용 헤더 삭제 |
PR·채팅 유출을 막습니다. |
| 200 응답 본문은 생략 또는 길이 제한 | 용량을 줄이고 인용할 4xx·5xx만 남깁니다. |
| 시작 시각 정렬 후 엔트리 상한(예: 80) | 모바일에서 Markdown·Webhook 본문이 읽힙니다. |
재시도 HAR은 trace 실패 시각과 맞는 파일만 남깁니다.
04
OpenClaw 템플릿 pr_min_repro_summary.md
슬롯만 채웁니다: 빌드·환경·재현 단계·네트워크 근거(메서드·경로·상태 몇 줄)·아티팩트 상대 경로. 입력은 trace_signals.json·트림 HAR·run_meta.json, 출력은 pr_min_repro_summary.md·status.txt. 모바일 unfurl을 위해 본문은 짧게 유지합니다.
실패 요청은 사용자 스텝과 POST /api/… → 4xx 한 줄을 반드시 짝지으세요.
05
선택: PR 코멘트·gh·Webhook
최소 권한·멱등·본문 무시크릿. 코멘트는 HTML 마커로 갱신·생성을 구분하세요.
curl -sS -X POST "$MIN_REPRO_WEBHOOK_URL" \
-H "Content-Type: application/json" \
-d "$(jq -n --rawfile body pr_min_repro_summary.md --arg sha "${GITHUB_SHA:-}" '{text: $body, sha: $sha}')"SHA 디바운스·429 백오프. HAR 금지 정책이면 Markdown만 PR, 바이너리는 버킷.
06 FAQ·트러블슈팅
빈 스텝: 컨텍스트·디스크 할당·Playwright 버전 드리프트를 점검하세요.
CORS·opaque HAR: trace 내비·콘솔과 합치고 page.request 여부를 명시.
401·중복 코멘트: 서명·egress·이스케이프 점검, 마커 갱신 또는 보고서 경로 락.
trace 모드·경로를 SHA마다 고정, trace_signals.json·트림 HAR→pr_min_repro_summary.md, Webhook은 다른 OpenClaw 게이트와 동일 레일. 원격 Mac은 대용량 trace·WebKit 병행에 유리합니다.
OpenClaw 파이프라인을 Safari 옆에서 24시간 돌리기
Mac Mini M4 노드에서 trace 압축 해제·HAR 마스킹·PR 요약을 상시 실행하세요. 요금·도움말(SSH·VNC)을 읽고 구매·예약으로 이동할 수 있으며 로그인 없이 진행 가능합니다.