二〇二六年　OpenClaw×n8n：レンタル Mac Mini で Webhook 分岐・回退・告警の最小手順

ホスト済み環境で破綻しやすい点

1. URL 揺れ。テスト URL のままだと本番有効化後に台帳と食い違います。
2. 認証片更新。片側だけローテすると四〇一が続きネット不安定に見えます。
3. 無制限再試行。下流 API が二重課金し得ます。run_id の重複排除を両側へ。

オーケストレーションの選び方（行列）

本番 URL と認証

本番リスナーを運用書へ。例https://n8n.example.com/webhook/openclaw-batch。GET 拒否・余剰動詞は四〇五。

• Bearer：Authorization: Bearerを両側で一致。
• HMAC：X-Signature、時刻ずれ二分まで。

分岐・失敗回退・告警

Webhook 直後にstatusやbatch_indexを評価し、成功は下流 HTTP、失敗は別レーンでチャットやオンコールへ。同一run_idを付けたPOST /hooks/batch-rollbackで冪等に掃除し、未捕捉はError Workflowへ集約します。

OpenClaw 側の最小設定（ひな形）

監督下に置き、秘密は環境ファイルのみ。

{"outbound_webhook":"https://n8n.example.com/webhook/openclaw-batch","method":"POST","headers":{"Authorization":"Bearer ${OPENCLAW_N8N_TOKEN}","Content-Type":"application/json"},"body_template":{"run_id":"{{run_id}}","batch_index":"{{batch_index}}","status":"{{status}}","payload_checksum":"{{sha256}}"},"retry":{"max_attempts":8,"initial_seconds":2,"max_seconds":900,"jitter_percent":30,"retry_on":[429,500,502,503,504]}}

HTTP 再試行の方針

ゲートウェイは四二九と列挙した五xxだけ自動再試行し、Retry-Afterを尊重します。四〇一・四〇三は秘密修正が先です。n8n 下流 HTTP にも回数上限を付け、繰り返し失敗は Error Workflow で七時二十四分でも人が気付けるようにします。

七手順チェックリスト

1. 完全 URLを台帳化。
2. 真偽枝と回退・告警の葉。
3. 秘密は同時ローテ。
4. JSON の再試行上限を保存、認証エラー除外。
5. Error Workflow とrun_id通知。
6. レンタル機から curl 実測。
7. 緑なら本番、料金で拡張。

よくある質問

四〇一を自動再試行してよいか

いいえ。修正後に手動一回。

貼る URL

本番 Webhook の完全形のみ。複製でテスト URL が変わる。

二重実行

安定 run_id と成功短絡。

引用三項

• 試行上限目安八回。
• 初回二秒・天井十五分・三割ジッタ。
• 署名時刻ずれ二分まで。