[OpenClaw 분석] 핵심 구성 요소 Gateway와 Node 개념 정리 (feat. macOS 앱)

이틀 전에 올린 'OpenClaw(구 Moltbot) 설치부터 구동까지'라는 아래 포스팅에서 잠깐 언급했지만 OpenClaw는 터미널에서 사용하는 CLI 외에 OpenClaw.app 이라는 이름의 MacOS 앱을 제공한다.

 

OpenClaw 프로젝트 릴리즈에 포함된 MacOS 앱

https://github.com/openclaw/openclaw/releases

Releases · openclaw/openclaw

OpenClaw의 버전이 올라갈 때마다 배포 페이지에서 소스와 함께 dmg 파일 형태로 MacOS 앱도 배포되고 있다. 앱의 이름은 OpenClaw.app이다.

착각하기 쉬운데 MacOS 앱은 터미널이 익숙하지 않은 비개발자를 위해 OpenClaw의 GUI 버전으로 CLI를 대신하는 역할의 앱이 아니다. 아래 공식 문서의 첫머리에도 명시돼 있지만 어디까지나 OpenClaw의 기능을 확장하고 보조하는 역할을 하는 컴패니언(companion) 앱이다.

https://docs.openclaw.ai/platforms/macos

macOS App - OpenClaw

MacOS 앱의 개념부터 시작해서 활용까지의 전체적인 내용은 별도 포스트로 작성할 예정이다. 이 포스트에서는 앱 사용 중에 내가 헷갈렸던 Gateway와 Node의 개념을 정리해 보려고 한다.

 

메뉴바 형태로 실행되는 OpenClaw MacOS 앱

OpenClaw Mac 앱은 화면 우측 상단에 메뉴바 형태로 실행되고, 아이콘을 우클릭하면 위 이미지와 같은 창이 뜬다. 한참 이것저것 눌러보며 살펴보고 있는데 순간 Gateway 두 개가 떠 있는 것처럼 보였다. OpenClaw 설치 과정에서 뭔가 꼬여서 이렇게 된 건가 싶었다. 하지만 결론을 먼저 말하자면 위쪽의 Gateway는 보이는 그대로 Gateway가 맞고, 아래쪽 'Garibong의 Mac mini'의 정체는 Gateway가 아닌 Node다.

반응형

 

OpenClaw Gateway와 Node의 개념과 역할

이제 OpenClaw의 Gateway와 Node가 무엇인지 살펴보겠다. 아래 그림과 같이 Gateway는 OpenClaw 자체라고 생각해도 크게 문제 되지 않을 정도로 핵심 요소다.

WhatsApp / Telegram / Discord / iMessage (+ plugins)
        │
        ▼
  ┌───────────────────────────┐
  │          Gateway          │  ws://127.0.0.1:18789 (loopback-only)
  │     (single source)       │
  │                           │  http://<gateway-host>:18793
  │                           │    /__openclaw__/canvas/ (Canvas host)
  └───────────┬───────────────┘
              │
              ├─ Pi agent (RPC)
              ├─ CLI (openclaw …)
              ├─ Chat UI (SwiftUI)
              ├─ macOS app (OpenClaw.app)
              ├─ iOS node via Gateway WS + pairing
              └─ Android node via Gateway WS + pairing

더 자세한 내용은 아래 공홈 페이지를 참고하기 바란다. 위의 그림도 여기서 긁어왔다.

https://docs.openclaw.ai/#how-it-works

OpenClaw - OpenClaw

Gateway는 일종의 서버로서 사람으로 따지면 두뇌라고 할 수 있고, 백그라운드에서 서비스(launchd)로 실행된다. 반면 Node는 손발에 해당하는 주변 장치로 macOS 앱도 수많은 Node 중 하나다. 알아보기 쉽게 표로 정리해 봤다.

	Gateway	Node
역할	서버 (두뇌)	주변장치 (손발)
주요 기능	OpenClaw의 핵심 기능 담당 - AI 모델 호출, 메시지 라우팅, 세션 관리 등	특정 기기 상에서 네이티브 레벨의 접근 제공 - 시스템 알림, 카메라, 화면 녹화, Canvas(WebView) 등
구동 방식	백그라운드 서비스 (launchd)	메뉴바 앱
단독 구동 여부	가능	불가능 (Gateway로의 접속 필요)

MacOS 앱에 한정해서 보면 아래와 같은 구조다.

Telegram → Gateway (127.0.0.1:18789) ← Node (macOS 앱)
              ↕                            ↕
         AI 모델 호출                 카메라, 알림, Canvas

정리하자면 하나의 기기에서 기본적으로 Gateway는 하나뿐이고, node는 여럿이 될 수 있다. 물론 port를 달리 해서 여러 Gateway를 띄울 수 있지만 이 글의 범위를 벗어나는 것 같아 자세히 다루지는 않겠다.

 

내 OpenClaw 봇에 의해 공개된 나의 무식함

이상의 내용은 내 OpenClaw 봇인 일라이(Eli)에게 묻고 답변받은 내용을 정리한 것이다. 그런데 일라이가 '봇마당'이라는 봇들만의 공개 포럼에 이 에피소드를 게시글로 올려서 공개했다. 당사자 입장에서는 골 때리는 일이지만 보는 분들은 재밌어하실 것 같아 공유한다.

https://botmadang.org/post/be232b7c8c89c9a01379a2a0

OpenClaw 아키텍처: Gateway와 Node, 뭐가 다른가

끝.

---

글이 도움이 됐다면 아래 공감(♥️) 아이콘 클릭 부탁드립니다^^