OpenClaw · Unlighthouse · Lighthouse · リモート Mac
2026 OpenClaw フロント実戦:リモート Mac で Unlighthouse JSON・死リンク閾値・Lighthouse 回帰要約を PR へ返す
2026.05.20
フロント/リリースゲート
約 9 分
想定読者:プレビューごとに内部リンクの 4xxとLCP/CLS 回帰を一枚の PR 表に載せたいフロントです。本文は選定表・Node 24 手順・JSON フィールド・閾値対照・OpenClaw 集約・Safari 分担・FAQ です。併読:プレビュー Lighthouse、Playwright JUnit 要約、トップ。
00 マージ前に止まる三つの理由
- 単 URL Lighthouseだけではサイト横断の 404 を見逃します。
- JSON が肥大し、票に貼るとレビュアが読めません。
- Chromium ラボ値と Safari 実機の差が PR で混ざり誤解が出ます。
01 Unlighthouse と単回 Lighthouse CLI の選定
| 観点 | Unlighthouse(サイト横断) | lighthouse CLI(単 URL) |
|---|---|---|
| 目的 | 内部リンク巡回・4xx・ルート一覧 | トップ/LP の Perf・A11y スコア |
| 出力 | unlighthouse.json(routes・links) |
lhr.json(audits) |
| CI 向き | PR ごと差分ルートの死リンク検出 | プレビュー URL の回帰ゲート |
| 併用 | 同一 OPENCLAW_RUN_ID で両方実行し OpenClaw が要約をマージ |
|
02 リモート Mac で Node 24+ と OpenClaw ゲートウェイを揃える
- Node 24+を固定(
.nvmrcまたは mise)。Unlighthouse は ESM 前提です。 - ゲートウェイに HMAC 付き Ingress を一本化し、秘密は Mac キーチェーンのみ。
- 出力先
.openclaw/reports/${OPENCLAW_RUN_ID}/をワーカーと共有。 - Chromium ビルドを lockfile でピン留め(Lighthouse 側と同じ)。
- 冪等キー
${git_sha}:unlighthouse+lighthouseを PR API と共有。
npx unlighthouse-ci --site "$PREVIEW_URL" --output-path "./.openclaw/reports/$OPENCLAW_RUN_ID/unlighthouse.json" --chrome-flags="--headless=new"03 Unlighthouse CI 出力 JSON の主要フィールド
解析スクリプトは次のキーのみ読めば票用表が組めます。
routes[]—path、score、各ルートのreportPathlinks.broken[]—href、status、発見元fromlinks.internal[]— ステータス分布の集計用summary.totalRoutes/failedRoutes— ヘッダ一行用
各ルートの Lighthouse 詳細は reportPath 配下の lhr.json を Deployments 連鎖稿と同じ閾値 JSON で読みます。
04 死リンク/4xx の閾値とブロック規則
| 条件 | 閾値(例) | 終了コード |
|---|---|---|
| 本番相当パスの 404 | 0 件(1 件でもブロック) | 2(回帰) |
| 4xx 合計(403 含む) | ≤ 3 かつすべて /draft 配下 |
2 超過でブロック |
| 5xx/タイムアウト | 任意 1 件 | 3(インフラ) |
| 外部リンク 4xx | 警告のみ(票に ⚠) | 0 のまま可 |
05 性能回帰(LCP/CLS)の閾値表
| 指標 | プレビュー上限 | ベースライン差分 |
|---|---|---|
| LCP | ≤ 2.5 s | main 比 +300 ms で 2 |
| CLS | ≤ 0.10 | + 0.03 で 2 |
| Perf スコア | ≥ 0.85 | − 0.05 で 2 |
閾値は perf/thresholds.json にコミットし、Bugsnag×Lighthouse 稿と同じ exit マップを使います。
06 OpenClaw で集約し PR コメント/Webhook へ返す
openclaw report merge(または同等)で deadlink 表と Perf 表を Markdown に結合。- マーカー
<!-- openclaw-ul:${git_sha} -->でコメント upsert。 - Webhook 経路は プレビュー Webhook 稿の署名検証を再利用。
- NDJSON に
phase=unlighthouse_deadlinkを 1 行追記し、JUnit 要約と同じ run フォルダへ。 - exit 0/2/3 を上位 Actions に返し、再試行はインフラのみ 1 回。
<!-- openclaw-ul:${GIT_SHA} -->
### サイト横断(Unlighthouse)
| 4xx | LCP 最悪 | CLS 最悪 | exit |
| ${broken_count} | ${lcp_worst} | ${cls_worst} | ${EXIT_CODE} |07 Safari/WebKit 連調の注意
Unlighthouse/Lighthouse は Chromium ラボです。ITP や navigator.storage 差は Safari 二系統マトリクスで短い WebKit スモークを別ジョブにします。PR 表の脚注に「WebKit は別 run」と一行書き、数値の混同を防ぎます。
08 よくあるエラー FAQ
- routes が空: sitemap・Basic 認証・robots をゲートウェイでウォームアップ。
- 403 のみヘッドレス: User-Agent と Cookie をプレビュー smoke と同一化。
- JSON 5MB 超: 上位 N ルートだけ票へ、全文は artifact。
- exit 2 と 3 の取り違え: 5xx・timeout は常に 3。
09 レビューに貼る引用メモ
- 本番パス 404 は ゼロ容認。draft 以外の 4xx は最大 3。
- 同一 run の artifact 保持は 14 日、票は表のみ。
- WebKit スモークは M クラスで 90 秒上限(trace は first-retry)。