2026 OpenClaw 前端实战：
远程 Mac 上网关 Webhook 接收预览 URL，串联 Lighthouse 阈值判定与 PR 可读摘要

托管商或中间层在预览就绪后 POST 一段 JSON；网关负责把不可信公网流量变成已验证任务：校验 X-OpenClaw-Signature（或平台 HMAC）、时间戳防重放、可选 IP 允许列表，并把 Idempotency-Key 与 git_sha 绑定。通过后写入内部队列，由远程 Mac上的 Runner 拉取——这样笔记本合盖不会掐断 Lighthouse，且与 CI 异构节点解耦。网关日志建议统一带 OPENCLAW_RUN_ID，便于和 NDJSON 报告、PR 摘要对齐。

1. 登记 Webhook。在网关配置路径（如 /hooks/preview-lighthouse）、共享密钥与最大 body 体积；拒绝非 application/json。
2. 约定载荷。至少包含 preview_url、git_sha、pr_number；可选 deployment_id 供与 Deployments 行合并展示。
3. 幂等。要求调用方带 Idempotency-Key: ${git_sha}:preview-lighthouse；网关层合并重复投递。
4. 入队 Mac。任务落到固定标签的 Runner；导出 PREVIEW_URL 与 OPENCLAW_RUN_ID。
5. 预热。对文档与主入口做幂等 GET，处理 302 直至 200，减轻冷启动造成的假阴性。
6. 跑 Lighthouse。示例：npx lighthouse "$PREVIEW_URL" --chrome-flags="--headless=new" --output=json --output-path="./.openclaw/reports/${OPENCLAW_RUN_ID}.lhr.json"；或使用 lhci autorun 读取仓库根 lighthouserc.json。
7. 断言阈值。用 lhci assert 指向上一步 manifest，或用小脚本解析 lhr.json 字段，失败执行 exit 1。
8. 回传摘要。将下方模板渲染为一行或短列表，POST 到 PR（或更新已有 Bot 评论）。
9. 归档。把 lhr.json 上传工件桶，PR 正文只保留分数与链接，避免泄露 Cookie。

下列数值为移动端表单常见起点，请按业务在仓库内调参并与近几次绿构建中位数对齐，减少抖动误杀。

推荐把断言放在 LHCI：lhci assert 在任一断言失败时以退出码 1结束，便于 CI 与 OpenClaw 任务状态机直接映射为失败。仅跑 lighthouse --output=json 时默认总为 0，必须在后续步骤用脚本比较阈值并自行 exit 1。

{
  "ci": {
    "collect": { "url": [ "${PREVIEW_URL}" ], "numberOfRuns": 1 },
    "assert": {
      "assertions": {
        "categories:performance": ["error", { "minScore": 0.82 }],
        "largest-contentful-paint": ["error", { "maxNumericValue": 2800 }],
        "cumulative-layout-shift": ["error", { "maxNumericValue": 0.12 }],
        "total-blocking-time": ["error", { "maxNumericValue": 350 }]
      }
    }
  }
}

保持一行主题 + 多行折叠，便于手机评审。勿附长效签名 URL 或密钥。

**OpenClaw / preview-lighthouse** · <PASS|FAIL> · run `OPENCLAW_RUN_ID`
- URL: <PREVIEW_URL>
- Perf / LCP / CLS / TBT: <n> / <ms> / <n> / <ms> (vs threshold: …)
- Top audits: <unused-javascript>, <render-blocking-resources>, …
- Report: <artifact or short-lived log link>
<!-- openclaw-plh:${GIT_SHA} -->

隐藏 HTML 注释用于 Bot 定位并更新同一条评论，避免刷屏。

默认 Lighthouse 使用打包的 Chromium，擅长回归与阈值门禁，但不等价于Safari / WebKit 的绘制与存储分区。建议在同一台远程 Mac上把本流水线定位为「Chromium 数值闸」，另接短任务：用 Playwright webkit 通道或人工打开 Safari 验证关键路径（Service Worker、IndexedDB、字体与滚动行为）。两类结果共用 OPENCLAW_RUN_ID 写入摘要，读者一眼区分「Lighthouse 包络」与「苹果系真机抽检」。