OpenClaw 원격 게이트웨이 및 노드 설정 가이드

개발을 하다 보면 여러 기기를 동시에 관리하는 게 정말 번거로울 때가 많아요. 특히 원격 서버에 있는 봇이 내 로컬 컴퓨터의 파일을 만지거나 화면을 제어해야 할 때, 보안과 편의성 사이에서 고민하게 되죠. 이런 복잡한 연결 문제를 OpenClaw가 어떻게 해결하는지 정리해 봤어요.

원격 접속을 설정하고 여러 장치를 조율하는 방법을 함께 알아볼까요?

Telegram, Gateway, Node 사이에서 명령은 어떻게 전달되나요?

Telegram 메시지는 Gateway가 처리해요. Gateway가 에이전트를 실행하고, Node 도구가 필요할 때만 Gateway WebSocket을 통해 Node를 호출하는 방식이죠.

Telegram → Gateway → Agent → `node.*` → Node → Gateway → Telegram

Node는 외부에서 들어오는 Provider 트래픽을 직접 보지 않고, 오직 Node RPC 호출만 받습니다.

Gateway가 원격에 있는데 에이전트가 제 컴퓨터에 어떻게 접속하나요?

짧게 답하자면, 컴퓨터를 Node로 페어링하면 돼요. Gateway는 다른 곳에서 실행되더라도 Gateway WebSocket을 통해 로컬 장치의 node.* 도구(screen, camera, system)를 호출할 수 있거든요.

일반적인 설정 방법:

1. 항상 켜져 있는 호스트(VPS 또는 홈 서버)에서 Gateway를 실행하세요.
2. Gateway 호스트와 본인의 컴퓨터를 동일한 tailnet에 연결하세요.
3. Gateway WS에 접속 가능한지 확인하세요 (tailnet 바인딩 또는 SSH 터널 이용).
4. 로컬에서 macOS 앱을 열고 Remote over SSH 모드로 연결하세요.
5. Gateway에서 Node를 승인하세요.

   openclaw nodes pending
   openclaw nodes approve <requestId>

Tailscale은 연결되었는데 응답이 없어요. 어떻게 해야 하나요?

먼저 기본적인 상태부터 확인해 보세요.

openclaw gateway status
openclaw status
openclaw channels status

그다음 인증과 라우팅을 확인하세요.

• Tailscale Serve를 사용한다면 gateway.auth.allowTailscale 설정이 올바른지 확인하세요.
• SSH 터널로 연결한다면 로컬 터널이 제대로 작동하고 포트가 맞는지 확인하세요.
• 허용 목록(DM 또는 그룹)에 본인 계정이 포함되어 있는지 확인하세요.

두 개의 OpenClaw 인스턴스(로컬 + VPS)가 서로 통신할 수 있나요?

네, 가능해요. 내장된 “봇 대 봇” 브리지는 없지만 직접 연결할 수 있어요.

가장 간단한 방법: 두 봇이 모두 접근할 수 있는 일반 채팅 채널(Telegram/Slack/WhatsApp)을 사용하세요. 봇 A가 봇 B에게 메시지를 보내게 하면 됩니다.

CLI 브리지:

openclaw agent --message "Hello from local bot" --deliver --channel telegram --reply-to <chat-id>

팁: 두 봇이 무한 루프에 빠지지 않도록 가드레일을 추가하는 것이 좋아요.

여러 에이전트를 위해 별도의 VPS가 필요한가요?

아니요. Gateway 하나에서 여러 에이전트를 호스팅할 수 있어요. 각 에이전트는 자신만의 워크스페이스, 모델 기본값, 라우팅을 가질 수 있죠. 이게 일반적인 설정 방식이고 훨씬 저렴하고 간단해요.

완전한 격리가 필요한 경우에만 별도의 VPS를 사용하세요.

VPS에서 SSH를 쓰는 것보다 개인 노트북에서 Node를 사용하는 게 더 좋은 점이 있나요?

네, Node는 원격 Gateway에서 노트북에 접근하는 가장 표준적인 방법이에요.

• 인바운드 SSH가 필요 없어요. Node가 Gateway WebSocket에 직접 연결하거든요.
• 실행 제어가 더 안전해요. system.run은 Node 허용 목록과 승인 절차를 거쳐야 해요.
• 더 많은 장치 도구를 쓸 수 있어요. Node는 system.run 외에도 canvas, camera, screen을 제공해요.
• 로컬 브라우저 자동화가 가능해요. Chrome을 로컬에서 실행하고 Chrome 확장 프로그램으로 제어권을 전달할 수 있어요.

두 번째 노트북에도 설치해야 할까요, 아니면 Node만 추가하면 될까요?

두 번째 노트북에서 로컬 도구(screen/camera/exec)만 필요하다면 Node로 추가하세요. 그래야 Gateway 하나로 관리할 수 있고 설정이 중복되지 않아요.

완전한 격리가 필요하거나 완전히 별개인 봇 두 개가 필요한 경우에만 두 번째 Gateway를 설치하세요.

Node에서도 Gateway 서비스를 실행하나요?

아니요. 의도적으로 격리된 프로필을 실행하는 게 아니라면, 호스트당 Gateway는 하나만 실행해야 해요.

VPS에 Tailscale을 설정하고 Mac에서 연결하려면 어떻게 하나요?

최소 단계:

1. VPS에 설치 및 로그인

   curl -fsSL https://tailscale.com/install.sh | sh
   sudo tailscale up

2. Mac에 설치 및 로그인

   • Tailscale 앱을 사용해 동일한 tailnet에 로그인하세요.

3. MagicDNS 활성화(권장)

   • Tailscale 관리 콘솔에서 MagicDNS를 켜서 VPS가 고정된 이름을 갖게 하세요.

4. tailnet 호스트네임 사용

   • SSH: ssh user@your-vps.tailnet-xxxx.ts.net
   • Gateway WS: ws://your-vps.tailnet-xxxx.ts.net:18789

SSH 없이 Control UI를 쓰고 싶다면 VPS에서 Tailscale Serve를 사용하세요.

openclaw gateway --tailscale serve

Mac Node를 원격 Gateway(Tailscale Serve)에 어떻게 연결하나요?

Serve는 Gateway Control UI와 WS를 노출해요. Node는 동일한 Gateway WS 엔드포인트를 통해 연결됩니다.

1. VPS와 Mac이 동일한 tailnet에 있는지 확인하세요.
2. Mac 앱을 Remote 모드로 사용하세요 (SSH 대상은 tailnet 호스트네임이 될 수 있어요).
3. Node를 승인하세요.

   openclaw nodes pending
   openclaw nodes approve <requestId>

설정을 적용하는 API나 RPC 방법이 있나요?

네, 있어요. config.apply는 전체 설정을 검증하고 저장한 뒤, 작업의 일부로 Gateway를 재시작해요.

첫 설치를 위한 최소한의 권장 설정은 무엇인가요?

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } }
}

이 설정은 워크스페이스를 지정하고 봇을 트리거할 수 있는 사용자를 제한해요.

AI Setup Assistant

다음 단계

• Gateway 설정 가이드
• Node 도구 활용하기