2026 OpenClaw 프론트 실전:
원격 Mac에서 게이트웨이 Webhook으로 프리뷰 배포 URL을 받고 Lighthouse·임계·종료 코드·PR 요약까지 한 줄로 재현

본문의 preview_url·SHA·PR·벤더 라벨을 파싱한 뒤 HMAC 또는 mTLS로 출처를 확인하고, 비 TLS·알 수 없는 호스트는 거절합니다. Idempotency-Key: ${GIT_SHA}:${OPENCLAW_RUN_ID}:preview-lh로 재전송 중복을 막고, 검증 후에는 Mac 에이전트에 URL·SHA·PR 튜플만 넘깁니다.

1. 식별자 export. GIT_SHA·PREVIEW_URL·PR_NUMBER·REPO_SLUG·OPENCLAW_RUN_ID를 한 번에 고정합니다.
2. Webhook 검증. 게이트웨이에서 타임스탬프 드리프트·서명·허용 IP 대역을 통과한 요청만 워커로 넘깁니다.
3. 프리뷰 워밍. Lighthouse가 쓸 User-Agent와 동일하게 HTML과 메인 번들에 GET을 두 번 보냅니다. 429면 짧게 백오프합니다.
4. Lighthouse CLI. 예: npx lighthouse "${PREVIEW_URL}" --only-categories=performance --output=json --output-path=".openclaw/reports/${OPENCLAW_RUN_ID}.lhr.json" --chrome-flags="--headless=new". Chromium 채널은 락파일 또는 환경 변수로 고정합니다.
5. 임계 로드. 같은 커밋의 perf/thresholds.json(또는 팀 규약 경로)을 읽어 아래 표의 지표와 비교합니다.
6. 종료 코드 매핑. 스크립트 예외는 1, 임계 미달은 2, 로드 타임아웃·DNS 등 인프라는 3, 전부 통과는 0으로 exit합니다. CI가 이 규약만 알면 머지 큐가 안정됩니다.
7. PR 요약. 아래 Markdown 템플릿을 채워 코멘트 upsert(숨은 마커 <!-- openclaw-preview-lh:${GIT_SHA} --> 권장) 또는 Checks 어노테이션에 동일 문자열을 붙입니다.
8. 관측 한 줄. OpenClaw NDJSON에 phase=preview_lighthouse·verdict·duration_ms·preview_host를 append하면 토큰·E2E 요약과 같은 런 id로 합류합니다.

# 워밍 예시 (실제 헤더는 벤더 스모크와 동일하게 맞출 것)
curl -fsS -A "${LIGHTHOUSE_UA}" -o /dev/null "${PREVIEW_URL}"
curl -fsS -A "${LIGHTHOUSE_UA}" -o /dev/null "${PREVIEW_URL%/}/_next/static/chunks/main.js" || true

저장소에 버전 관리되는 JSON은 “측정값이 이 선을 넘으면 실패”만 담고, 비밀·URL TTL은 넣지 않습니다. 숫자 단위(lhr 필드명과 일치)를 주석 README에 적어 두면 리뷰어가 diff만으로 의미를 읽습니다.

{
  "performance": { "minScore": 0.88 },
  "metrics": {
    "largest-contentful-paint": { "maxNumericValue": 2800 },
    "cumulative-layout-shift": { "maxNumericValue": 0.08 },
    "total-blocking-time": { "maxNumericValue": 350 }
  }
}

코멘트 본문은 네 줄 안팎이 가장 읽힙니다. 숫자·단위·프리뷰 호스트만 바꾸고 나머지 문장은 고정해 팀이 패턴을 외웁니다.

<!-- openclaw-preview-lh:${GIT_SHA} -->
### OpenClaw · 프리뷰 Lighthouse (${OPENCLAW_RUN_ID})
- **판정:** ${VERDICT} · **호스트:** ${PREVIEW_HOST}
- **Perf:** ${PERF_SCORE} (min ${MIN_SCORE}) · **LCP:** ${LCP_MS} ms (max ${LCP_MAX_MS}) · **CLS:** ${CLS} (max ${CLS_MAX})
- **아티팩트:** \`.openclaw/reports/${OPENCLAW_RUN_ID}.lhr.json\` 동일 커밋
- **다음:** WebKit 스모크 ${WEBKIT_STATUS}

Chromium 측정 직후 동일 PREVIEW_URL에 WebKit 스모크를 짧게 붙이면 Safari 출시 리스크를 같은 Mac 비용으로 덮습니다. NDJSON·PR에 chromium_lab+webkit_smoke 태그를 남기세요. Deployments와 묶는 그림은 연동 글을 참고합니다.