基礎

Gateway アーキテクチャ

最終更新日: 2026-01-22

概要

単一の長寿命な Gateway が、すべてのメッセージングサーフェス (Baileys 経由の WhatsApp、grammY 経由の Telegram、Slack、Discord、Signal、iMessage、WebChat) を所有します。
コントロールプレーンクライアント (macOS アプリ、CLI、Web UI、自動化) は、設定されたバインドホスト (デフォルト 127.0.0.1:18789) 上の WebSocket を介して Gateway に接続します。
ノード (macOS/iOS/Android/ヘッドレス) も WebSocket を介して接続しますが、明示的な caps/commands と共に role: node を宣言します。
ホストごとに 1 つの Gateway。これは WhatsApp セッションを開く唯一の場所です。
キャンバスホスト は、Gateway HTTP サーバーによって以下のパスで提供されます:
- /__openclaw__/canvas/ (エージェント編集可能な HTML/CSS/JS)
- /__openclaw__/a2ui/ (A2UI ホスト) Gateway と同じポート (デフォルト 18789) を使用します。

role: node を指定して 同じ WS サーバー に接続します。
connect でデバイス ID を提供します。ペアリングは デバイスベース (ロール node) であり、承認はデバイスペアリングストアに保存されます。
canvas.*、camera.*、screen.record、location.get などのコマンドを公開します。

プロトコルの詳細:

トランスポート: WebSocket、JSON ペイロードを持つテキストフレーム。
最初のフレーム は必ず connect でなければなりません。
ハンドシェイク後:
- リクエスト: {type:"req", id, method, params} → {type:"res", id, ok, payload|error}
- イベント: {type:"event", event, payload, seq?, stateVersion?}
OPENCLAW_GATEWAY_TOKEN (または --token) が設定されている場合、connect.params.auth.token が一致しなければソケットは閉じられます。
べき等性キーは、副作用のあるメソッド (send、agent) を安全に再試行するために必要です。サーバーは短命な重複排除キャッシュを保持します。
ノードは connect に role: "node" と caps/commands/permissions を含める必要があります。

すべての WS クライアント (オペレーター + ノード) は、connect 時に デバイス ID を含めます。
新しいデバイス ID はペアリング承認を必要とします。Gateway は、その後の接続のために デバイストークン を発行します。
ローカル 接続 (ループバックまたは Gateway ホスト自身の tailnet アドレス) は、同じホストでの UX をスムーズにするために自動承認されることがあります。
すべての接続は connect.challenge ノンスに署名する必要があります。
署名ペイロード v3 は platform + deviceFamily もバインドします。Gateway は再接続時にペアリングされたメタデータを固定し、メタデータ変更時にはペアリングの再設定を要求します。
非ローカル 接続は、依然として明示的な承認を必要とします。
Gateway 認証 (gateway.auth.*) は、ローカルまたはリモートを問わず すべての 接続に適用されます。

代替: SSH トンネル

コピー

ssh -N -L 18789:127.0.0.1:18789 user@host