二〇二六年 OpenClaw レンタル Mac Mini 実践:汎用 HTTP Webhook(Zapier/Make)で日報摘要と退避再試行を再現する手順
レンタル Mac Mini で OpenClaw を長期常駐し日報摘要を汎用 HTTP Webhook で出す際、ポート迷子や再試行による四二九増幅が典型です。表と七手順、JSON 項目、認証 FAQ を示します。運用は月次でも年次でも同じ型に載せられます。四二九 HowTo、定時 Webhook 稿、ヘルプへ。
- 再起動でポートが変わり気付きにくい。
- 診断と本番を同一 URL に混ぜると本番通知が汚れる。
- 冪等なし再試行で二重投稿が起きる。
オーケストレータ比較(抜粋)
| レーン | 向く場合 | 注意 |
|---|---|---|
| Zapier | Zap 内で SaaS まで繋ぐ | タスク枠・遅延上限 |
| Make | 分岐の再利用 | ログ保持枠 |
| curl | 秘密の第三者保管を減らす | ローテはスクリプト |
ゲートウェイ常駐とポート番号(リスンと境界)
ゲートウェイは固定 TCP ポートをループバックまたは tailnet に拘束し、外向きは TLS 反代のみ。ヘルスと推論をパス分離し、番号をランブックに残します。
Webhook ルーティング設定
POST /hooks/digest と /hooks/alert を分け、メソッドと Content-Type を先に検証し、不正動詞は四〇五です。
{"route":"/hooks/digest","method":"POST","content_type":"application/json","auth":"Bearer"}
Zapier/Make の最小シナリオ例
Zapier:Catch Hook→severity Filter→通知。Make:Webhook→Router(run_id)→必要なら ACK のみ HTTP。窓はスケジュール行列に合わせます。
日報摘要テンプレートのフィールド(JSON)
run_id、window_start/window_end(TZ 付 ISO-8601)、summary_text(四 KB 目安)、severity、source_host を毎回そろえます。
四二九・五xx の退避再試行と冪等キー
再試行は四二九と五〇〇台のみ。Retry-After優先、無ければ二秒から指数退避・三十パーセントジッター・十五分上限・八回で停止。Idempotency-Key=run_id を推奨します。
よくある認証失敗 FAQ
- 四〇一(Zapier のみ等)
- Bearer 空白・二重接頭辞・改行。生ヘッダ比較。
- HMAC 失敗
- 時刻ずれ二分超。NTP と TZ 確認。
- ローテ順
- ゲートウェイ→金庫→旧鍵廃止。
再現手順(七手順)
- アドレス・ポート・plist を記録。
- TLS で digest/alert を分離。
- 受け口 URL とシークレット欄のみ。
- run_id と窓を必須 JSON で出力。
- 退避設定、四〇一・四〇三 は再試行しない。
- 認証失敗はマスクログ+ request id。
- 一週間安定で本番化しコンソールで契約更新。
引用(三行)
- 二秒起点・十五分帽・八回で人手。
- 署名は二分以内の時刻ずれを目安。
- summary_text は四 KB 目安。
長期ホスティング向けに一度ルートと退避を固定してください。ホーム・購入・ヘルプ・ブログ・料金。
一覧へ。