OpenClaw.app을 Remote Gateway에 연결하기

로컬에서 작업하다가 원격에 있는 Gateway에 연결하려고 하면 설정이 복잡해서 막막할 때가 있죠. 매번 터미널을 열어 명령어를 입력하는 것도 꽤 귀찮은 일이고요. OpenClaw.app을 원격 Gateway와 연결해 더 효율적으로 작업할 수 있는 방법을 정리해 드릴게요.

보안을 유지하면서도 간편하게 연결을 관리하고 싶을 때 SSH 터널링은 아주 좋은 해결책이 됩니다. 이 가이드를 따라가면 자동으로 연결되는 안정적인 환경을 만들 수 있어요.

이 콘텐츠는 Remote Access로 통합되었습니다. 최신 가이드는 해당 페이지를 확인해 주세요.

원격 Gateway에서 OpenClaw.app 실행하기

OpenClaw.app은 SSH 터널링을 사용해 원격 Gateway에 연결해요. 이 가이드에서는 그 설정 방법을 설명해 드릴게요.

개요 (Overview)

flowchart TB
    subgraph Client["Client Machine"]
        direction TB
        A["OpenClaw.app"]
        B["ws://127.0.0.1:18789\n(local port)"]
        T["SSH Tunnel"]

        A --> B
        B --> T
    end
    subgraph Remote["Remote Machine"]
        direction TB
        C["Gateway WebSocket"]
        D["ws://127.0.0.1:18789"]

        C --> D
    end
    T --> C

빠른 설정 (Quick Setup)

Step 1: SSH Config 추가

~/.ssh/config 파일을 수정해서 아래 내용을 추가해 주세요.

Host remote-gateway
    HostName <REMOTE_IP>          # e.g., 172.27.187.184
    User <REMOTE_USER>            # e.g., jefferson
    LocalForward 18789 127.0.0.1:18789
    IdentityFile ~/.ssh/id_rsa

<REMOTE_IP>와 <REMOTE_USER> 부분은 실제 값으로 바꿔주면 돼요.

Step 2: SSH Key 복사

공개 키를 원격 머신에 복사하세요 (비밀번호는 한 번만 입력하면 돼요).

ssh-copy-id -i ~/.ssh/id_rsa <REMOTE_USER>@<REMOTE_IP>

Step 3: Gateway Token 설정

launchctl setenv OPENCLAW_GATEWAY_TOKEN "<your-token>"

Step 4: SSH 터널 시작

ssh -N remote-gateway &

Step 5: OpenClaw.app 재시작

# Quit OpenClaw.app (⌘Q), then reopen:
open /path/to/OpenClaw.app

이제 앱이 SSH 터널을 통해 원격 Gateway에 연결될 거예요.

---

로그인 시 터널 자동 시작 (Auto-Start Tunnel on Login)

로그인할 때 SSH 터널이 자동으로 시작되도록 Launch Agent를 만들어 볼게요.

PLIST 파일 생성

~/Library/LaunchAgents/ai.openclaw.ssh-tunnel.plist 경로에 아래 내용을 저장하세요.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>ai.openclaw.ssh-tunnel</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/bin/ssh</string>
        <string>-N</string>
        <string>remote-gateway</string>
    </array>
    <key>KeepAlive</key>
    <true/>
    <key>RunAtLoad</key>
    <true/>
</dict>
</plist>

Launch Agent 로드

launchctl bootstrap gui/$UID ~/Library/LaunchAgents/ai.openclaw.ssh-tunnel.plist

이제 터널이 다음과 같이 작동해요.

• 로그인할 때 자동으로 시작돼요.
• 연결이 끊기면 자동으로 다시 시작해요.
• 백그라운드에서 계속 실행돼요.

참고: 이전에 사용하던 com.openclaw.ssh-tunnel LaunchAgent가 남아 있다면 삭제해 주세요.

---

문제 해결 (Troubleshooting)

터널이 실행 중인지 확인하기:

ps aux | grep "ssh -N remote-gateway" | grep -v grep
lsof -i :18789

터널 재시작하기:

launchctl kickstart -k gui/$UID/ai.openclaw.ssh-tunnel

터널 중지하기:

launchctl bootout gui/$UID/ai.openclaw.ssh-tunnel

---

작동 원리 (How It Works)

구성 요소	역할
LocalForward 18789 127.0.0.1:18789	로컬 포트 18789를 원격 포트 18789로 전달해요
ssh -N	원격 명령을 실행하지 않고 SSH 연결만 유지해요 (포트 포워딩 전용)
KeepAlive	터널이 중단되면 자동으로 다시 시작해요
RunAtLoad	에이전트가 로드될 때 터널을 시작해요

OpenClaw.app은 클라이언트 머신의 ws://127.0.0.1:18789에 접속해요. 그러면 SSH 터널이 이 연결을 Gateway가 실행 중인 원격 머신의 18789 포트로 전달해 주는 방식이에요.

다음 단계

• Remote Access 가이드에서 더 자세한 내용을 확인해 보세요.

설정 중에 궁금한 점이 생기면 언제든 AI Setup Assistant에게 물어봐 주세요!