つまずき
- ノードごと Webhook で穴とローテが台数分に増える。
- 生ログ直投げで要約が長くモバイルで潰れる。
- 四xx を無限リトライすると二重送とレートに当たる。
Webhook 設定
スペースで Incoming Webhook を作り URL はゲートウェイのみが読むファイルへ。application/json の markdown 先頭にワークフロー・枝・短 SHA・成否。Mac から外向き POST はせずキューへ。出口は webexapis.com のみ。型は Mattermost・Teams と揃えると楽です。
最小権限
再試行退避
四xx・五xx
| 区分 | 原因の例 | 対応 |
|---|---|---|
| 四xx | JSON 誤り・空 markdown | 即リトライせず修正。冪等キーは据え置き |
| 四〇一 | URL 失効 | 再発行し秘密更新。フェイルオーバー |
| 四二九 | バースト | 並列低下・キュー合流・ゲートウェイ FAQ |
| 五xx | 一時障害 | バックオフ再試行 |
切り分けはキュー到達・ゲートウェイ POST ログ・応答本文の順。共有通知 も参照。
手順と切り分け
| 観点 | 単一ゲートウェイ | 各ノード直 POST |
|---|---|---|
| 協働価値 | 秘密一つ・mesh_node_id で脚注揃え | ローテと体裁が散る |
- 1 Webhook 作成し URL を秘密ファイルへ。
- 2 ゲートウェイでキューを markdown に整形。
- 3 curl で短文テスト。
- 4 失敗のみログ URL を末尾に。
- 5 四半期ローテ演習で旧 URL を grep 確認。
目安:待ち一秒〜六十秒・ファイル〇四四〇・要約十行・冪等は run_id と state。
まとめ
単一路・一秘密・指数退避・四xx は無リトライが最小セット。OpenClaw 特集・ブログ一覧 へ。