オープンクロー就地がジェンキンス汎用ウェブフックを検証しプリフライト後に要約をエイチティーティーピーで戻す手順です。ノード二十二・十六以上または二十四系列、
openclaw doctor、トークンとヘルスが前提です。排障・リカバリ・硬化併読。
前提のつまずき
直公開・プロキシ改変・共有クローン汚れが署名ずれとプリフライトブレの主因です。
判断表：待受・認証・作業領域・戻し
| 観点 | 推奨 | 避ける |
|---|---|---|
| 待受 | ループバック＋トンネル | 広域無認証 |
| 身元 | トークン＋秘密ヘッダ | 短いクエリのみ |
| 検証 | ビルド単位隔離 | 共有ツリー |
| 戻し | ポスト＋冪等＋バックオフ | 一発失敗放置 |
環境と最小権限の準備
二十四系列か二十二・十六以上に固定しシェルとローンチディーのパスを揃えドクターで証明書を点検します。トークンはキーチェーンに閉じ外向きはウェブフックのみ。ローンチエージェントでヘルス監視し落ちたら再起動します。
ジェンキンス汎用ウェブフックと署名・トークン検証パラメータ
汎用トリガーに一意トークンを付け秘密ヘッダまたは生ボディのエイチマックを照合します。プロキシはバッファ無効とチャンク透過を確認します。ジェイソンにジョブ・ビルド・コミット・成否を載せ重複キーで抑止します。
オープンクロー側の受信とコンポーザ／エヌピーエムプリフライトのコマンド雛形
隔離ディレクトリで浅取得し下記を実行し終了コードを要約へ載せます。
composer validate --no-check-publish --no-interaction
composer install --no-dev --no-progress --prefer-dist --no-interaction
npm ci --prefer-offline --no-audit --no-fund
ビルド要約のエイチティーティーピー／ウェブフック回帰と失敗時リトライ
成否・秒数・ログ末尾・ジョブ識別子をジェイソンで戻し先へポストします。五〇二やタイムアウトは指数バックオフで三回再試行し残りは保留キューへ退避します。手順はノード固定、ループバック、二層検証、隔離プリフライト、要約ポスト、ヘルス周期の六段です。
よくあるエラー切り分けエフエーキュー
四〇一／署名不一致
秘密の食い違いとプロキシ改変を疑い生バイトで照合します。
プリフライトのみ失敗
権限・キャッシュ・ロック欠落・ミラー到達を順に見ます。
要約が届かない
相手の証明書・タイムアウト・レート制限を切り分け間隔を空けます。