존재했던 이유
- 보안 경계: 전체 Gateway API 표면 대신 소규모 허용 목록만 노출했습니다.
- 페어링 + 노드 ID: Gateway가 노드 허용을 담당했으며, 노드별 토큰에 연결했습니다.
- 검색 UX: 노드는 LAN에서 Bonjour를 통해 Gateway를 검색하거나 tailnet을 통해 직접 연결할 수 있었습니다.
- 루프백 WS: SSH를 통해 터널링하지 않는 한 전체 WS 제어 영역은 로컬에 유지되었습니다.
전송 방식
- TCP를 사용하며, 한 줄당 하나의 JSON 객체(JSONL)를 전송합니다.
- 선택적 TLS(
bridge.tls.enabled: true). - 기본 리스너 포트는
18790이었습니다.
bridgeTls=1과 bridgeTlsSha256이 포함되었습니다. Bonjour/mDNS TXT 레코드는 인증되지 않으므로, 클라이언트는 별도의 대역 외 검증 없이는 공지된 지문을 신뢰할 수 있는 고정 값으로 취급할 수 없었습니다.
핸드셰이크 및 페어링
- 클라이언트가 노드 메타데이터와 토큰(이미 페어링된 경우)을 포함한
hello를 전송합니다. - 페어링되지 않은 경우 Gateway가
error(NOT_PAIRED/UNAUTHORIZED)로 응답합니다. - 클라이언트가
pair-request를 전송합니다. - Gateway가 승인을 기다린 후
pair-ok와hello-ok를 전송합니다.
hello-ok가 serverName을 반환했습니다. 현재 Gateway 프로토콜에서는 호스팅되는 Plugin 표면을 pluginSurfaceUrls를 통해 알립니다(Canvas/A2UI는 pluginSurfaceUrls.canvas를 사용).
프레임
클라이언트에서 Gateway로:req/res: 범위가 제한된 Gateway RPC(채팅, 세션, 구성, 상태, 음성 깨우기, skills.bins).event: 노드 신호(음성 전사, 에이전트 요청, 채팅 구독, 실행 수명 주기).
invoke/invoke-res: 노드 명령(canvas.*,camera.*,screen.record,location.get,sms.send).event: 구독한 세션의 채팅 업데이트.ping/pong: 연결 유지.
src/gateway/server-bridge.ts에 있었습니다(제거됨).
실행 수명 주기 이벤트
노드는 완료된system.run 활동을 표시하기 위해 exec.finished를 내보냈으며, Gateway가 이를 시스템 이벤트로 매핑했습니다(레거시 노드는 exec.started도 내보낼 수 있었습니다). exec.denied는 거부된 system.run 시도를 시스템 이벤트 큐에 추가하거나 에이전트 작업을 깨우지 않고 최종 거부 상태로 표시했습니다.
페이로드 필드(별도 표기가 없는 한 모두 선택 사항):
과거 tailnet 사용법
~/.openclaw/openclaw.json에서 브리지를 tailnet IP에 바인딩합니다:bridge.bind: "tailnet"(과거에만 해당하며,bridge.*는 더 이상 유효한 구성이 아닙니다).- 클라이언트는 MagicDNS 이름 또는 tailnet IP를 통해 연결했습니다.
- Bonjour는 네트워크를 넘어 작동하지 않으므로, 그 외의 경우에는 광역 DNS-SD 또는 수동 호스트/포트가 필요했습니다.