ゲートウェイのインストールとヘルスチェック
URL はプール増減で回さないのが Mesh の利点。mesh_node_id は表記用、API/チャット出站はゲートウェイ集約。
- 手順 1. ゲートウェイに OpenClaw、
OPENCLAW_CONFIG_ROOT、LaunchDaemon 等で常駐(プールは再起動しがちなので入口だけ安定)。 - 手順 2. Linear 用
https://…でリバプロ終端、Webhook パスに本文上限(TLS 入口)。 - 手順 3.
openclaw doctor、GET /healthまたは ヘルスプローブ で LB 排出を確認。 - 手順 4.
correlation_idとキュー遅延をログ化、同時数は レート制限 FAQ に合わせる。共有通知・OpenClaw 特集。
Linear の署名検証
共有ビルドスクリプトとの連携
正規化タスク(repo・ref・issue・actor・idempotency_key)。A が忙しくても B が同じ入口を実行、Webhook は増やさない。
- 手順 1. 対象カラム/ラベルのみ処理、他は早
200。 - 手順 2. 共有キューへ issue ・チーム・冪等キーで投入(再試行手順)。
- 手順 3. 全ノード同一エントリ(版固定、worktree)。
- 手順 4. 完了に
mesh_node_id等を載せゲートウェイが Slack/Chat/Teams へ一斉送信。 - 手順 5. GraphQL で短コメント返却、キーは最小スコープ・ローテ 同型。
GHA と併用時は Runner ルーティング でレーン分離。
失敗時の再試行と通知
FAQ
- curl は通るが本番だけ署名失敗
- 実バイト列と curl 本文の差、gzip/WAF を疑う。マスクした生ボディで再検証。
- カード移動が速いと二重ジョブ
- デバウンスか「ビルド準備」ラベル必須。issue・カラム・短時間窓で冪等キー。
- 緑ビルドなのにコメントなし
- キー権限、
issueId、GraphQLerrorsを確認。 - 入口はゲートウェイ一台でよいか
- はい。秘密と監査を一点に集約し、ノード追加は容量の話に留める。