2026 OpenClaw フロント実戦：
リモート Mac で REST／OpenAPI 契約 diff とスモーク curl 一括を連係（失敗要約）

典型は三つです。契約の発見が遅い、スモークが断片化してトークンや URL が人依存、失敗が散らばると判断が遅れる、です。

artifacts/api/<buildId>/ に基線・現行・diff・集計・meta.json を置き、終了コード 0／1／2 を固定します。OpenClaw はエクスポート→diff→curl→要約の順、通知は buildId で冪等にします。

node -v とロックを CI に揃え、diff CLI は devDependencies へ。実行ユーザーは .env.ci と内網へ届く非対話シェルにし、証明書はキーチェーンか SSL_CERT_FILE。初回はクリーンで手動し、artifacts/.../logs/ を確認してから自動化します。

cd /path/to/repo && npm ci && npm install -D @pb33f/openapi-changes
# チーム合意の oasdiff / openapi-diff 等に差し替え可

openclaw run --workspace /path/to/repo --env-file .env.ci \
  --steps export-openapi,openapi-diff,smoke-curl,notify-summary

基線はマージ済み、現行はゲートウェイ等から。同一フォーマッタ後に比較し、破壊的件数でゲート、報告は build 配下へ。

mkdir -p artifacts/api/$BUILD_ID
curl -sS -o artifacts/api/$BUILD_ID/openapi.current.json "$OPENAPI_URL"
cp contracts/openapi.baseline.yaml artifacts/api/$BUILD_ID/
npx oasdiff breaking contracts/openapi.baseline.yaml \
  artifacts/api/$BUILD_ID/openapi.current.json > artifacts/api/$BUILD_ID/diff.txt

一覧でケース名・パスを読み curl -w '%{http_code}' でコードだけ溜め、本文は短く切って JSON 化。トークンは env、プロキシは HTTPS_PROXY／NO_PROXY をタスクに渡します。

BASE_URL="${BASE_URL}"
while read -r name ep; do
  code=$(curl -sS -o /dev/null -w "%{http_code}" -H "Authorization: Bearer $API_TOKEN" \
    --max-time 15 "$BASE_URL$ep" || echo err)
  echo "{\"case\":\"$name\",\"code\":\"$code\"}" >> artifacts/api/$BUILD_ID/curl.ndjson
done < scripts/smoke-endpoints.tsv

diff.txt と curl 集計から summary.md を生成し通知へ。プリフライトの後・Playwrightより前が定石。監査と artifacts を揃えると閲覧が楽です。