2026 OpenClaw フロント実戦:
リモート Mac で Playwright trace.zip と HAR — 最小復現手順を PR に返す
trace.zip+トリム HAR を OpenClaw で pr_min_repro_summary.md にし PR へ。手順:エクスポート→展開→HAR→Markdown→PR/Webhook。関連:E2E トリアージ、自動修正、Docker、Source Map。
01 trace エクスポート:CI と Mac で同じ記録にする
use.trace を on/retain-on-failure/on-first-retry のいずれかに固定し、screenshot・video と整合させます。only-on-failure なら要約フッターに明記します。
CLI は --trace on 等を文書化し、成果物は .openclaw/reports/<git-sha>/traces/。run_meta.json にリポジトリ・SHA・Playwright 版・ベース URL・認証モードのみ(秘密は書かない)。
ビューアなしで JSON 化できることが前提。 WebKit は Safari 互換検証参照。
02
trace.zip を展開し、最初に読むフィールドを抜く
unzip 後、trace.trace(アクション)・trace.network(HTTP)・失敗ステップ付近のコンソールを読み、trace_signals.json に最終 URL、ステップ列、失敗ステップ ID、ネットワーク行(最大二十行前後)をまとめます。
URL はセッション系クエリを除き、localhost を web/api 等の呼び名に寄せ、失敗タブ以外は落とします。
Cookie/JWT を JSON に載せず、認証は「storageState を CI 秘密で」など手順のみ。
03 HAR トリミング:バグを証明する最小サイズへ
HAR は対象オリジン+パス接頭辞のみ、Authorization/Cookie 等を削除、200 本文は省き 4xx/5xx のみ必要なら短く残す、時系列で並べエントリ上限(例 80)。出力 repro.har.trimmed.json。リトライ時は失敗試行に一致する HAR のみ。
04
OpenClaw テンプレ:pr_min_repro_summary.md
五節:ビルド・環境・手順・HTTP 証拠(三至六行)・成果物(ストアパスをリポ相対)。
- 入出力:
trace_signals.json+repro.har.trimmed.json+run_meta.json→pr_min_repro_summary.mdとstatus.txt(ready等)。 - 長さ:モバイルで読めるよう短く(目安四百語未満)。
POST /api/... → 4xx をセットで書くとレビューが速い。
05
(任意)PR コメント、gh、Webhook
gh pr comment または fine-grained PAT。HTML コメントで <!-- openclaw-min-repro-sha:… --> を付け冪等化。Webhook 例:
curl -sS -X POST "$MIN_REPRO_WEBHOOK_URL" \
-H "Content-Type: application/json" \
-d "$(jq -n --rawfile body pr_min_repro_summary.md --arg sha "${GITHUB_SHA:-}" '{text: $body, sha: $sha}')"
SHA デバウンス・429 バックオフ・失敗は status.txt。HAR 禁止なら Markdown のみ。
06 トラブルシュート FAQ
空ステップ:コンテキスト・ディスク・版ズレ。opaque HAR:trace と併記し API 経路を明示。401/二重投稿/ダンプ禁止:各ゲートと同様にシークレット・冪等・ストア分離。
SHA 単位で trace/HAR/Markdown を固定し、返却は最小権限と冪等で他ゲートと同じ。リモート Mac は trace 容量と WebKit 近接に向く。