2026 OpenClaw 프론트 실전:
원격 Mac 게이트웨이로 GitHub Deployments·Lighthouse 회귀·임계 판정·PR 가독 요약까지 한 번에 재현
대상: OpenClaw를 원격 Mac에 두고 프리뷰 URL에 Lighthouse 회귀를 걸되, 판정을 PR 타임라인과 GitHub Deployments 행에 동시에 남기고 싶은 팀입니다. Webhook은 의도, deployment 객체는 상관 키, deployment_status는 사람이 읽는 한 줄 상태로 쪼개면 벤더 콘솔 URL을 돌려도 동일 스토리를 유지할 수 있습니다. 단일 슬러그 예시는 2026-openclaw-remote-mac-github-deployments-lighthouse.html이며 중첩 디렉터리 slug는 쓰지 않습니다. 선행 읽기: Lighthouse 임계 알림, Vercel 배포 훅 스모크, 토큰·E2E 요약.
프리뷰는 캐시·지리·쿠키 때문에 CI 컨테이너와 다른 Lighthouse 결과를 냅니다. 임대 원격 Mac으로 실제 Chromium 채널을 고정하고, OpenClaw 게이트웨이는 서명 Webhook만 받아 GitHub REST로 판정을 남깁니다. 토큰·E2E 요약과 같이 OPENCLAW_RUN_ID를 공유하면 로그와 UI가 한 줄로 맞습니다.
완료 정의. preview/lighthouse 배포가 pending→success|failure로 바뀌고 PR 코멘트에 동일 숫자 요약이 보이면 끝입니다. 연동 모델은 Webhook=의도, deployment=상관키, deployment_status=사람이 읽는 상태입니다. Vercel 훅·Cloudflare 훅의 preview_url·pr_number를 그대로 넣으면 벤더 스크립트 복제를 줄입니다.
판정 채널 매트릭스.
| 채널 | 강점 | 주의 |
|---|---|---|
| Checks | 단계 로그·재실행. | 모바일 한눈 판독 약함. |
| Deployments | environment_url과 한 줄 판정. |
환경 문자열·멱등 규칙 필수. |
| PR 코멘트 | 리뷰 타임라인 검색. | 비밀·스팸 위험. |
01 재현 HowTo
GIT_SHA·PREVIEW_URL·PR_NUMBER·REPO_SLUG·OPENCLAW_RUN_IDexport./deploymentsPOST 시ref=SHA,environment=preview/lighthouse, 메타에 런 id./statuses로pending과 짧은 워밍 문구.- 동일 UA로 HTML·메인 JS 멱등 GET 두 번.
- Lighthouse CLI 또는 LHCI로 측정,
lhr.json을.openclaw/reports/${OPENCLAW_RUN_ID}.lhr.json에 저장. 임계는 임계 알림 글처럼 저장소에 고정. - 점수·LCP·CLS·TBT를 기준선 또는 최근 초록 중앙값과 비교해 통과·실패만 기록.
success|failure상태에 숫자 델타 한 줄,environment_url=PREVIEW_URL.- 동일 텍스트를 PR 코멘트로 거울링.
- 게이트웨이가
Idempotency-Key: ${GIT_SHA}:${OPENCLAW_RUN_ID}:lighthouse를 강제. - NDJSON에
phase=lighthouse_github·deployment_id·verdict·duration_ms를 append해 빌드 메트릭 PR 요약과 합류.
상태 설명은 약 4KB에서 잘리므로 델타만 남기고 lhr.json은 아티팩트로 보냅니다. Chromium 리비전을 고정하지 않으면 LCP 분산이 커집니다.
02 최소 권한 토큰
classic repo 대신 단일 저장소 fine-grained PAT 또는 GitHub App 설치 토큰을 쓰고 값은 게이트웨이 환경 변수에만 둡니다.
| 권한 | 이유 | 회피 |
|---|---|---|
| Contents 읽기 | 기준선 JSON fetch. | 불필요한 쓰기. |
| Deployments 쓰기 | 배포·상태. | 조직 공용 관리 토큰. |
| Pull requests 쓰기 | 요약 코멘트. | 머지 권한 포함 봇. |
03 트러블슈팅
- 404: fine-grained 저장소 허용 목록·앱 설치 범위 확인.
- 중복 deployment: 목록 API로 최신 id 재사용 또는 서버 멱등.
- 프리뷰만 실패: 쿠키·지역 헤더는 env로만, PR 본문 금지.
- LCP 플레이크: Chromium 고정 후 동일 id로 재시도, 기준선은 중앙값.
04 FAQ
아티팩트만으로는?
엔지니어용 로그는 아티팩트, 사람 판정은 deployment_status+PR 코멘트로 나눕니다.
Safari도 같은 id?
가능. WebKit 측정도 동일 상관 키·멱등 헤더를 유지하세요.
repo_hook 관리 권한?
훅이 이미 있으면 deployment·PR 범위+서명 검증만으로 충분합니다.
원격 Mac에서 성능 판정을 고정하고 전환까지 이어가기
홈, 요금, 도움말, 구매·렌탈은 로그인 없이 열 수 있습니다. 심화 길잡이는 Lighthouse 임계 알림, Vercel 배포 훅 스모크, 블로그 목록을 이어서 읽어 주세요.