🔗 給在遠端實體 Mac銜接 builds.sr.ht 者：含可複現安裝、Node 二十四、閘道探針串聯驗收、映像併發與碟水位矩陣，以及Webhook→預拉取→合併摘要→回傳步驟與權杖／TLS／埠問答。內鏈：列表、Webhook 範式、說明。
痛點：跨境拉取、鎖檔漂移與建置附訊不足
（一）冷啟動拉套件延遲大，逾時難判因。（二）合併未更鎖檔，解析樹與宣告不一致，錯誤延後。（三）執行器缺統一探針輸出，難對齊工作附註。
安裝與版本門檻：curl、npm 與 Node 二十四
須 Node 二十四主版次；未達請先升級，再擇一官方路徑。
node --version curl -fsSL https://openclaw.ai/install.sh | bash npm install -g openclaw@latest
禁全域裝時改使用者目錄或容器封裝；openclaw 須在 PATH。續做下節串聯驗收。
串聯驗收：閘道狀態、診斷與設定校驗
單一區塊依序執行，輸出附建置日誌；非零碼即中止並標失敗摘要。
openclaw doctor openclaw gateway status openclaw config validate
對外 Webhook 須校驗監聽位址、權杖標頭與傳輸層；見 閘道權杖硬化。
決策矩陣：映像併發、Git 重試與碟水位
下列對照表歸納常見產線之保守與積極組合，供值班調參。
| 維度 | 保守策略 | 積極策略 | 取捨提示 |
|---|---|---|---|
| 映像併發 | 每節點一至二作業 | 三至四作業 | 積極須盯快取鎖與佇列 |
| Git 重試 | 三次退避上限六十秒 | 五次上限一百二十秒 | 過多易觸頻率限 |
| 碟水位 | 可用大於百分之三十五 | 大於百分之二十二 | 低於閾值降併發並清暫存 |
多租戶綁作業識別碼隔暫存；跨境參 Git 頻寬矩陣。
步驟清單：Webhook 至回傳 CI
1
設定 Webhook：HTTPS 端點、簽章或密鑰、限來源網段。
2
預拉取：收事件後檢出，依矩陣 Git 重試，每作業獨立快取根。
3
lockfile 掃描：比鎖檔雜湊與解析輸出；漂移則單行結論加建議指令。
4
合併摘要：併預拉取日誌、漂移、gateway status、doctor 成一段 JSON 或純文字。
5
回傳：OAuth 或權杖呼叫 builds API，寫工作附註或上傳日誌工件。
curl -sS -X POST -H "Authorization: Bearer ${SRHT_TOKEN}" \
-H "Content-Type: application/json" \
--data "{\"body\":\"${SUMMARY_ESCAPED}\"}" \
"https://builds.sr.ht/api/jobs/${JOB_ID}/notes"
端點與欄位以官方文件為準。
可引用資訊
（一）執行器說明寫 Node 主版、OpenClaw 版、安裝路徑。（二）密鑰輪替與權杖範圍入值班表。（三）碟監控設水位告警與降載觸發條件。
常見問題
權杖如何最小化？
僅給寫附註或上傳日誌範圍；勿下發完整帳號長效檔。
Webhook 要驗 TLS 嗎？
建議全程 HTTPS 校驗鏈；代理終止 TLS 時後段仍限來源並驗簽章。
埠 18789 衝突？
改設定監聽埠或釋放行程；本機 curl 確認綁定位址與協定。
lockfile 漂移擋合併？
影響可重現建置則擋並要求更鎖檔；純文件變更可寬鬆但留稽核。
Git 重試拖長流水線？
設單次逾時與退避上限，依頻寬調矩陣；必要時 bundle 或預熱物件庫。