Files
obsidian/openclaw/openclaw-architecture.md
kappa a1592f7898 openclaw: 매뉴얼을 섹션별 파일로 분리 (14개)
단일 파일에서 디렉토리 구조로 변경하여 컨텍스트 관리 용이하게 함.
openclaw-manual.md는 위키링크 인덱스로 변환.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-18 17:03:22 +09:00

1.1 KiB

title, updated
title updated
OpenClaw 아키텍처 2026-03-18

게이트웨이(Gateway)가 중앙 데몬으로 모든 메시징 채널을 관리. 호스트당 1개만 존재. 기본 127.0.0.1:18789.

구조

채널(WhatsApp/Telegram/Discord...) ← WebSocket → 게이트웨이 ← WebSocket → 클라이언트(CLI/macOS앱/웹UI)
                                                      ↕
                                                   노드(macOS/iOS/Android)

구성요소

  • 게이트웨이: 메시징 연결 유지, WebSocket API, JSON Schema 검증
  • 클라이언트: 게이트웨이에 WebSocket 연결, send/agent/status 요청
  • 노드: role: node로 연결, 기기 ID 기반 페어링, camera/screen 등 명령

연결 프로토콜

  • 첫 프레임은 반드시 connect 요청
  • 요청/응답: {type:"req", id, method, params}{type:"res", id, ok, payload}
  • 이벤트: {type:"event", event, payload}
  • 보안: 새 기기는 페어링 승인 필요, 로컬은 자동 승인
  • 원격: Tailscale/VPN 또는 SSH 터널 (ssh -N -L 18789:127.0.0.1:18789 user@host)