대부분의 작업은 게이트웨이(openclaw gateway)를 통해 처리됩니다. 게이트웨이는 채널 연결과 WebSocket 제어 평면을 관리하는 단일 상주 프로세스입니다.

핵심 규칙

• 호스트당 하나의 게이트웨이를 권장합니다. 게이트웨이만이 WhatsApp Web 세션을 소유할 수 있습니다. 복구 봇이나 엄격한 격리가 필요한 경우, 격리된 프로필과 포트로 여러 게이트웨이를 실행하세요. 다중 게이트웨이를 참고하세요.
• 루프백 우선: 게이트웨이 WS의 기본값은 ws://127.0.0.1:18789입니다. 설정 마법사는 루프백 환경에서도 기본적으로 게이트웨이 토큰을 생성합니다. Tailnet 접근 시에는 openclaw gateway --bind tailnet --token ...을 사용하세요. 비루프백 바인딩에는 토큰이 필수입니다.
• 노드는 필요에 따라 LAN, Tailnet 또는 SSH를 통해 게이트웨이 WS에 연결합니다. 레거시 TCP 브리지는 더 이상 지원되지 않습니다.
• 캔버스 호스트는 게이트웨이 HTTP 서버에서 게이트웨이와 동일한 포트(기본값 18789)로 제공됩니다:
  • /__openclaw__/canvas/
  • /__openclaw__/a2ui/ gateway.auth가 설정되어 있고 게이트웨이가 루프백을 넘어서 바인딩된 경우, 이 경로들은 게이트웨이 인증으로 보호됩니다. 노드 클라이언트는 활성 WS 세션에 연결된 노드 범위 기능 URL을 사용합니다. 게이트웨이 설정 (canvasHost, gateway)을 참고하세요.
• 원격 사용에는 일반적으로 SSH 터널이나 Tailnet VPN을 사용합니다. 원격 접근 및 디스커버리를 참고하세요.