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 マージ前に止まる三つの理由

  1. 単 URL Lighthouseだけではサイト横断の 404 を見逃します。
  2. JSON が肥大し、票に貼るとレビュアが読めません。
  3. 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 ゲートウェイを揃える

  1. Node 24+を固定(.nvmrc または mise)。Unlighthouse は ESM 前提です。
  2. ゲートウェイに HMAC 付き Ingress を一本化し、秘密は Mac キーチェーンのみ。
  3. 出力先 .openclaw/reports/${OPENCLAW_RUN_ID}/ をワーカーと共有。
  4. Chromium ビルドを lockfile でピン留め(Lighthouse 側と同じ)。
  5. 冪等キー ${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、各ルートの reportPath
  • links.broken[] — href、status、発見元 from
  • links.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 へ返す

  1. openclaw report merge(または同等)で deadlink 表と Perf 表を Markdown に結合。
  2. マーカー <!-- openclaw-ul:${git_sha} --> でコメント upsert。
  3. Webhook 経路は プレビュー Webhook 稿の署名検証を再利用。
  4. NDJSON に phase=unlighthouse_deadlink を 1 行追記し、JUnit 要約と同じ run フォルダへ。
  5. 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)。
次の一手

フロント CI 用リモート Mac ビルドノードを選ぶ

Unlighthouse と Lighthouse を同一 Mac で再現。料金・Webhook 稿・ブログ一覧。

フロント CI ノードをレンタル