HowTo · OpenClaw · Linear · 多ノード · Webhook

2026 OpenClaw MeshMac 実践:Linear Webhook で共有ビルド状態をブロードキャストし要約を返す最小再現手順

2026年4月10日 Meshmac 読了目安 約6分

MeshMac 多ノードでは LinearPOSTゲートウェイ一台のみ。検証後に共有キューへ載せ、チャットは一本ブロードキャスト、要約は GraphQL で返します。マルチノードデプロイ協働 と併読。

ゲートウェイのインストールとヘルスチェック

URL はプール増減で回さないのが Mesh の利点。mesh_node_id は表記用、API/チャット出站はゲートウェイ集約。

  1. 手順 1. ゲートウェイに OpenClaw、OPENCLAW_CONFIG_ROOT、LaunchDaemon 等で常駐(プールは再起動しがちなので入口だけ安定)。
  2. 手順 2. Linear 用 https://… でリバプロ終端、Webhook パスに本文上限(TLS 入口)。
  3. 手順 3. openclaw doctorGET /health または ヘルスプローブ で LB 排出を確認。
  4. 手順 4. correlation_id とキュー遅延をログ化、同時数は レート制限 FAQ に合わせる。共有通知OpenClaw 特集

Linear の署名検証

検証→解析の順。Linear は生ボディ署名。先パースは典型失敗要因。

  1. 手順 1. Webhook 秘密を 0440最小権限保管(例 …/linear/webhook.secret)。
  2. 手順 2. バイト列バッファの上で HMAC-SHA256、Linear-Signature を定数時間比較。リプレイ窓は厳めに。
  3. 手順 3. 不一致は 401、メタのみマスク(Teams 通知 と同衛生)。
  4. 手順 4. キュー durable 後のみ 200。再送増殖を防ぐ(キュー同期)。

共有ビルドスクリプトとの連携

正規化タスク(repo・ref・issue・actor・idempotency_key)。A が忙しくても B が同じ入口を実行、Webhook は増やさない。

  1. 手順 1. 対象カラム/ラベルのみ処理、他は早 200
  2. 手順 2. 共有キューへ issue ・チーム・冪等キーで投入(再試行手順)。
  3. 手順 3. 全ノード同一エントリ(版固定worktree)。
  4. 手順 4. 完了に mesh_node_id 等を載せゲートウェイが SlackChatTeams へ一斉送信。
  5. 手順 5. GraphQL で短コメント返却、キーは最小スコープ・ローテ 同型。

GHA と併用時は Runner ルーティング でレーン分離。

失敗時の再試行と通知

受信と送信の再試行は分離、通知は一本化。

  1. 手順 1. durable エンキュー後は速応答。ハンドラ時間は 同時実行 FAQ 内。
  2. 手順 2. チャットは 429/一時 5xx のみ指数バックオフ、idempotency_key + state で去重。
  3. 手順 3. GraphQL は errors[] ログ、401 はループしない。
  4. 手順 4. 両方続けて失敗なら IM、ゲートウェイは LB/FO

FAQ

curl は通るが本番だけ署名失敗
実バイト列と curl 本文の差、gzip/WAF を疑う。マスクした生ボディで再検証。
カード移動が速いと二重ジョブ
デバウンスか「ビルド準備」ラベル必須。issue・カラム・短時間窓で冪等キー。
緑ビルドなのにコメントなし
キー権限、issueId、GraphQL errors を確認。
入口はゲートウェイ一台でよいか
はい。秘密と監査を一点に集約し、ノード追加は容量の話に留める。

まとめ・次の一手(公開ページのみ)

ゲートウェイ・署名・共有キュー・ブロードキャスト・GraphQL の五点が多ノード最小セット。公開ナビのみ:ホームブログヘルプOpenClaw購入 は下段 CTA。

MeshMac 多ノード · Linear 一本化 · 閲覧はログイン不要

ビルダーを足しても Webhook は増やさない

共有 Mac プールで OpenClaw と Linear をつなぐなら、入口はゲートウェイだけに固定し、台数は実行能力として積み上げるのが 2026 年の現実的な運用です。プラン・ノード数の目安(購入ページ) で必要な並列とストレージを確認し、ヘルプセンター の SSH/VNC/ゲートウェイ手順とあわせて読むと導入が速いです。ホームブログアカウント不要で閲覧できます。

プランへ