OpenClaw Gateway 설정 가이드: 5분 만에 연결 최적화

분산된 환경에서 여러 봇 세션을 관리하다 보면 네트워크 설정이 꼬여서 고생할 때가 많죠. 특히 세션 유지와 보안을 동시에 챙기는 건 정말 까다로운 일이에요. OpenClaw는 Gateway 중심의 깔끔한 네트워크 모델로 이 문제를 해결해 줍니다.

네트워크 모델 (Network Model)

이 콘텐츠는 Network로 통합되었습니다. 현재 가이드는 해당 페이지를 확인해 주세요.

대부분의 작업은 Gateway(openclaw gateway)를 통해 흐르게 됩니다. Gateway는 채널 연결과 WebSocket 제어 평면(control plane)을 소유하는 단일 실행 프로세스예요.

핵심 규칙 (Core rules)

• 호스트당 하나의 Gateway를 사용하는 것을 권장해요. WhatsApp Web 세션을 소유할 수 있는 유일한 프로세스이기 때문이죠. 구조용 봇이나 엄격한 격리가 필요한 경우에는 격리된 프로필과 포트를 사용하여 여러 개의 Gateway를 실행하세요. Multiple gateways를 참고해 보세요.
• 루프백(Loopback)을 우선으로 해요. Gateway WS의 기본값은 ws://127.0.0.1:18789입니다. 마법사(wizard)는 루프백 환경이라도 기본적으로 Gateway 토큰을 생성해요. tailnet 접속을 원한다면 openclaw gateway --bind tailnet --token ... 명령어를 실행하세요. 루프백이 아닌 바인딩에는 토큰이 필수거든요.
• Node들은 필요에 따라 LAN, tailnet 또는 SSH를 통해 Gateway WS에 연결돼요. 기존의 TCP 브릿지는 더 이상 사용되지 않아요(deprecated).
• Canvas 호스트는 Gateway와 동일한 포트(기본값 18789)의 Gateway HTTP 서버에서 제공돼요:
  • /__openclaw__/canvas/
  • /__openclaw__/a2ui/ gateway.auth가 설정되어 있고 Gateway가 루프백 외부로 바인딩된 경우, 이 경로들은 Gateway 인증으로 보호돼요. Node 클라이언트는 활성화된 WS 세션에 연결된 Node 범위의 capability URL을 사용합니다. Gateway configuration (canvasHost, gateway)을 확인해 보세요.
• 원격 사용은 보통 SSH 터널이나 tailnet VPN을 이용해요. Remote access와 Discovery를 참고해 보세요.

---

궁금한 점이 있나요? AI Setup Assistant에게 물어보세요!

다음 단계

• Gateway 설정 가이드
• 원격 접속 설정하기
• 멀티 Gateway 운영하기