OpenClaw 네트워크 허브: 게이트웨이 연결 및 보안 설정 가이드

여러 장치를 연결하다 보면 네트워크 설정 때문에 머리가 아플 때가 많죠? 로컬호스트에서 잘 돌아가던 게 LAN이나 VPN으로 넘어가면 갑자기 안 되기도 하고요. OpenClaw가 이런 연결 문제를 어떻게 해결하는지 정리해 드릴게요.

네트워크 허브

이 허브는 OpenClaw가 localhost, LAN, tailnet을 통해 장치를 연결하고 페어링하며 보안을 유지하는 핵심 문서들을 연결해 줍니다.

대부분의 작업은 openclaw gateway 명령어로 실행되는 Gateway를 통해 이루어져요. 이 프로세스는 채널 연결과 WebSocket 제어 평면을 관리하는 단일 실행 프로세스입니다.

Loopback 우선: Gateway WS의 기본값은 ws://127.0.0.1:18789예요. Loopback이 아닌 주소에 바인딩하려면 토큰이 꼭 필요합니다.
호스트당 하나의 Gateway를 권장해요. 격리가 필요한 경우에는 프로필과 포트를 분리해서 여러 개의 Gateway를 실행할 수 있습니다 (Multiple Gateways).
Canvas host는 Gateway와 동일한 포트(/__openclaw__/canvas/, /__openclaw__/a2ui/)에서 서비스됩니다. Loopback 이외의 주소에 바인딩할 때는 Gateway 인증으로 보호돼요.
Remote access는 보통 SSH 터널이나 Tailscale VPN을 사용합니다 (Remote Access).

주요 참고 문서:

로컬 신뢰:

로컬 연결(loopback 또는 Gateway 호스트 자체의 tailnet 주소)은 동일 호스트에서의 사용자 경험을 위해 페어링 승인을 자동으로 처리할 수 있어요.
로컬이 아닌 tailnet/LAN 클라이언트는 여전히 명시적인 페어링 승인이 필요합니다.

OpenClaw Expert

이 문서에서 답을 못 찾았다면 OpenClaw Expert에게 바로 물어보세요.