2026 OpenClaw 可觀測實戰:
遠端 Mac 閘道串聯 Token 用量面板、模型鑑權狀態卡與 E2E 冒煙失敗摘要
在遠端 Mac以 OpenClaw 閘道跑 Playwright 冒煙時,代幣仍動但鑑權看似卡住最難分診。本文給五步接線、決策表、通用 Webhook 摘要(免登入雲端控制台),並專章寫閘道檢查、報告欄位對接、閾值與常見問題。延伸:/v1/models 對齊、部署 Hook、追蹤摘要。範例:2026-openclaw-token-auth-e2e-summary-remote-mac.html。💻
追蹤錄影難見閘道背壓與權杖範圍;把階段化可觀測欄位與 Playwright 結尾併讀,才能分辨代幣上升來自預檢重試或主流程。
痛點。分片綠燈但 auth_state 降級;提示代幣在劇本前陡升;時鐘偏移致間歇四零一;摘要僅總量無階段難對齊 Hook。
決策矩陣。
| 證據來源 | 擅長 | 盲點 |
|---|---|---|
| 供應商主控台 | 帳務長趨勢。 | 難對齊單次執行編號。 |
| 閘道日誌加 Webhook | 部署即時分診、冪等去重。 | 須遮罩主機與權杖。 |
| 僅報告檔 | 選擇器與追蹤。 | 缺鑑權語意。 |
五步接線。
- 匯出
OPENCLAW_RUN_ID、GIT_SHA、BASE_URL、模型別名,閘道與 Runner 同名。 - 每階段寫
gateway.ndjson:階段、耗時、提示/完成代幣、auth_state、http_status。 npx playwright test --reporter=json產report.json與日誌同目錄。jq或 Node 合併為smoke_summary/v1,標準輸出去敏。- 送 Webhook 附冪等鍵:提交、執行編號、摘要型別。
模板。固定 schema 版本;鍵名示意如下(組織內補齊必填)。
{
"schema": "smoke_summary/v1",
"openclaw_run_id": "run_…",
"git_sha": "abc123…",
"base_url": "https://staging.example",
"gateway": {
"auth_state": "ok|degraded|blocked",
"prompt_tokens": 0,
"completion_tokens": 0,
"last_http_status": 200,
"last_latency_ms": 0
},
"playwright": {
"status": "passed|failed|timedOut",
"failed_spec": "tests/smoke/checkout.spec.ts",
"shard": "webkit",
"exit_code": 1
},
"failed_phase": "gateway_preflight|playwright_smoke|summary_post"
}
若 failed_phase 指閘道預檢而 Playwright 逾時,先查權杖與閘道逾時再下鑽 DOM;全程無需供應商後台。
01 閘道側檢查項
歸咎 Playwright 前於遠端 Mac 核銷下列項,並對照 模型冒煙清單。
- 時鐘:記錄偏移毫秒併入
auth_state行。 - 權杖:Runner 與手動探測用同一枚最小權限。
- 副本:寫
upstream_pod或請求編號對齊代幣尖峰。 - 別名:同入站網址打
/v1/models與設定檔差分。 - 降級:定義
degraded是否仍允許唯讀探針。
每行帶 OPENCLAW_RUN_ID 便於橫向日誌與報告。提示代幣升、完成代幣平,多為預檢重試。聊天附錄截斷標準錯誤並改連工件。
02 與 Playwright 報告欄位對接思路
自 report.json 抽鍵入摘要;正規化可仿 建置指標 PR 摘要。
| 來源 | 摘要欄位 | 用途 |
|---|---|---|
stats.expected/unexpected |
assertion_delta |
代幣仍動時區分介面與基建。 |
workerIndex |
worker_index |
分片對齊閘道尖峰。 |
errors[].message |
first_error |
人讀一句加追蹤欄位。 |
timedOut 時併送 testTimeout 與 gateway.last_latency_ms;延遲低且鑑權阻擋則先續權杖。
03 閾值告警
以訊號不一致觸發人工,減少單一指標虛警。
- 五分鐘提示代幣斜率逾該檔中位數兩倍且 Playwright 仍通過。
- 單次執行內
auth_state翻轉逾三次且非排定輪替。 - Playwright 牆鐘較基線增加逾五成而閘道延遲仍平。
基線敘事見 Web 運維監控。
04 常見問題
代幣仍動卻失敗?
健康檢查與嵌入重試先推高代幣;請對齊階段與分片勿只看總量。
可略過雲端控制台?
可,若入站、閘道、Runner 同欄位寫標準輸出與 Webhook;摘要勿內嵌僅登入可開之連結。
冪等鍵怎麼設?
組合 GIT_SHA、執行編號與冒煙檔名即可去重又允許同提交多檔。