2026 OpenClaw 前端實戰:
遠端 Mac 對接 Bugsnag Build API、Lighthouse 閾值判定與 PR 可讀摘要
適用對象:已部署預覽、想把 單一可審計的 Web 發布門禁串起 Bugsnag 發布中繼資料、Lighthouse 預算與一則 GitHub 可讀摘要的前端團隊。固定 slug:2026-openclaw-remote-mac-bugsnag-build-lighthouse-pr-summary.html。建議與預覽 Webhook × Lighthouse、GitHub Deployments 狀態聯動、建置度量 PR 摘要併讀,釐清「誰觸發量測」與「誰寫入狀態欄」邊界。
容器 Runner 成本低,但對真實使用者效能往往過吵:冷 DNS、遠端預覽區域與限 CPU 會獨自拉高 LCP,難以判斷是前端還是基礎設施回歸。與驗收方共址的遠端 Mac 租賃節點能以低延遲打開與設計師相同的預覽網址,讓 Lighthouse 較貼近人類體感。Bugsnag 已掌握 appVersion、releaseStage、revision;OpenClaw 應把該三元組當成授權謂詞,通過後才在 headless Chrome 花數分鐘。網關共用的鑑權冒煙可對照權杖 E2E 摘要。
以下為 HowTo 與排障:含API 權杖、觸發條件、庫內閾值表、Markdown 摘要模板、可選與 openclaw doctor 輸出合併;假設網關與 Safari 冒煙共用同一台 Mac 與 Chromium 頻道。
01 此模式排除的痛點
- 訊號脫鉤。Lighthouse 留言到了,儀表板卻沒有對應 Bugsnag Build 列,審查者無法一行對齊。
- 高延遲 CI。跨區往返帶來抖動,程式無恙仍反覆撞預算。
- 權杖發散。Runner 上單一 mega-token 易從日誌外洩且難旋轉。
02 API 權杖與訊號矩陣
| 機密 | 用途 | 存放 |
|---|---|---|
| BUGSNAG_PERSONAL_AUTH_TOKEN | 呼叫組織層級 HTTP API,列舉或驗證 Build。 | OpenClaw 網關環境變數或 macOS 鑰匙圈;建議季旋轉。 |
| BUGSNAG_NOTIFIER_API_KEY | 以 CI 或 Mac 寫入 Build 中繼資料(含 appVersion 與 sourceControl.revision)。 |
絕不入庫;執行期注入。 |
| GITHUB_TOKEN(精細權限) | 冪等 upsert PR 留言,可選寫入 deployment 摘要。 | 僅限儲存庫範圍;勿授予合併權。 |
03 可複現 HowTo 步驟
- 凍結關聯欄位。匯出
GIT_SHA、PREVIEW_URL、PR_NUMBER、OPENCLAW_RUN_ID、RELEASE_STAGE,使 Bugsnag 載荷與 Lighthouse 檔名一致。 - 登記 Build。自 CI 或網關呼叫 Bugsnag 建立 Build,讓儀表板 revision 與即將門禁的預覽相同。
- 套用觸發條件。僅當
releaseStage落在白名單(例如staging/production)且revision等於GIT_SHA時繼續;純文件 PR 直接跳過。 - 暖站後量測。自 Mac 對 HTML 與最大 script bundle 做冪等 GET,再以
--preset=desktop與--only-categories=performance跑 Lighthouse(除非另追 PWA)。 - 評估閾值。以庫內 JSON 預算比對;失敗則在貼綠字前先讓工作非零退出。
- 渲染並回傳。套用下方模板,可將
openclaw doctor尾段包進摺疊區塊,再以 HTML 註解鍵 upsert 機器人 PR 留言。
04 Lighthouse 參數與閾值
Chromium 頻道應與內部文件一致。實務 CLI 骨架:lighthouse "${PREVIEW_URL}" --chrome-flags="--headless=new" --output=json --output-path=.openclaw/reports/${OPENCLAW_RUN_ID}.lhr.json --preset=desktop --max-wait-for-load=90000。將 perf/thresholds.json 納版控,任一預算退步即失敗。
| 指標 | 示例預算 | 備註 |
|---|---|---|
| Performance 分類分數 | 最低 0.85 |
預覽易冷啟時可與近三次綠燈中位數對照。 |
| LCP | p75 上限 2500 ms |
應在暖站 GET 後量測,而非僅首次導覽。 |
| CLS | 最大 0.08 |
小數三位四捨五入可忽略次閾值雜訊。 |
| TBT | 最大 200 ms |
第三方腳本在白名單內時可暫時放寬並註記原因。 |
將退出碼 2 視為效能回歸、3 視為基礎設施逾時,便於佇列僅對後者自動重試而不掩蓋真債務。
05 PR 摘要模板與可選 doctor 合併
正文建議壓在約 4 KB 內,避免 GitHub 行動版截斷數字。可選衛生:將 openclaw doctor 導向暫存檔,只取最末四十行包在 text 程式碼圍欄內,審查者能快速看到 PATH、Node、Chromium 漂移,又不遮住 Lighthouse 表格。
### OpenClaw · Bugsnag · Lighthouse({{OPENCLAW_RUN_ID}})
**預覽:** {{PREVIEW_URL}}
**Revision:** `{{GIT_SHA}}` · **Bugsnag 階段:** `{{RELEASE_STAGE}}`
| 指標 | 預算 | 實測 | 差值 |
| --- | --- | --- | --- |
| Perf 分數 | ≥0.85 | {{perf}} | {{perf_delta}} |
| LCP ms | ≤2500 | {{lcp}} | {{lcp_delta}} |
<details><summary>openclaw doctor(可選)</summary>
```text
{{DOCTOR_SNIP}}
```
</details>
延伸將閾值告警做成排程時,可參考Lighthouse 效能告警步驟,與本文的「每次合併前單次裁決」分工。
06 排障
- Bugsnag HTTP 401。重發個人權杖、確認 URL 組織 slug、並檢查權杖仍具 Build 讀取範圍。
- revision 不一致。預覽仍指向較舊提交——請在部署 Hook 完成後再跑一次 Build 建立。
- Lighthouse 403。沿用權杖冒煙流程中的保護標頭鏡像,或將 Mac 出口 IP 納入允許清單。
- LCP 飄移過大。釘選 Chromium、暫停 Mac 上無關 GUI 工作,並與近三次綠燈中位數比較。