2026 OpenClaw 實戰：TeamCity Webhook 觸發預檢、lockfile 掃描與建置摘要

1）安裝：官方指令或 npm i -g openclaw；openclaw onboard 後跑 openclaw doctor 驗證憑證與埠。

2）閘道：僅綁 127.0.0.1，外層 TLS 終止；launchd 常駐並寫死 PATH／NODE_BINARY，與 SSH 互動一致。

3）目錄：每次 mktemp -d，結束刪除，避免並行覆寫暫存依賴。

• 閘道儀表板使用窄用途 Bearer；與 TeamCity 入站共享祕鑰、REST 寫回權杖分桶存放。
• 每 60 秒探針 /health，異常告警並保留最近日誌便於比對。

# 閘道健康（替換 PORT、GATEWAY_TOKEN）
curl -sS -o /dev/null -w '%{http_code}\n' \
  -H 'Authorization: Bearer YOUR_GATEWAY_TOKEN' \
  --connect-timeout 3 --max-time 10 \
  http://127.0.0.1:PORT/health

痛點：筆電閘道易斷線、權杖過大難稽核、lockfile 漂移未前移而浪費佇列與頻寬。

於專案／型樣啟用 Webhook：在「建置開始」等事件 POST JSON（含 buildId、revision 等）。URL 用長隨機路徑當共享祕鑰，可再加標頭或 HMAC（對原始本文）。Personal Access Token 僅給讀建置與寫註解所需範圍。

Handler：驗祕鑰或 HMAC → 淺克隆與 checkout 修訂版 → git diff 看 lock 與 manifest → npm ci --dry-run → tail 取摘要。組態建置宜由上層型樣聚合觸發一次，避免子組態重試風暴。

# lockfile 與乾跑（示例）
git diff --exit-code origin/main -- package-lock.json || true
npm ci --dry-run 2>&1 | tail -n 60

• 子程序加 timeout，避免占滿外掛連線。
• 完整輸出落盤再以 tail 做摘要，便於對時戳排查。

預檢後以 curl 呼叫 TeamCity REST（註解或第二 Webhook），附 Bearer；路徑依版次文件。設 --connect-timeout、--max-time；非 2xx 用二四八秒退避至多五輪並落盤；排查時對齊閘道日誌與外掛請求序號。

# 摘要 POST 示例（替換 SERVER、BUILD_LOCATOR、TOKEN）
curl -sS -X POST "https://SERVER/app/rest/builds/BUILD_LOCATOR/comment" \
  -H 'Content-Type: text/plain' \
  -H "Authorization: Bearer $TC_REST_TOKEN" \
  --data-binary @/tmp/preflight-summary.txt \
  --connect-timeout 5 --max-time 25

1. Node 22+、onboard、doctor。
2. 閘道回環、Bearer、launchd、/health。
3. TeamCity Webhook：JSON、修訂版、祕鑰或 HMAC。
4. Handler：暫存目錄、lock diff、npm ci --dry-run。
5. REST 回寫摘要；二四八秒重試；比對日誌。