원격 Gateway(게이트웨이)와 함께 OpenClaw.app 실행하기¶

OpenClaw.app은 SSH 터널링을 사용하여 원격 Gateway(게이트웨이)에 연결합니다. 이 가이드는 설정 방법을 안내합니다.

개요¶

%%{init: {
  'theme': 'base',
  'themeVariables': {
    'primaryColor': '#ffffff',
    'primaryTextColor': '#000000',
    'primaryBorderColor': '#000000',
    'lineColor': '#000000',
    'secondaryColor': '#f9f9fb',
    'tertiaryColor': '#ffffff',
    'clusterBkg': '#f9f9fb',
    'clusterBorder': '#000000',
    'nodeBorder': '#000000',
    'mainBkg': '#ffffff',
    'edgeLabelBackground': '#ffffff'
  }
}}%%
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

빠른 시작¶

1단계: SSH 설정 추가¶

~/.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>을 본인의 값으로 바꾸십시오.

2단계: SSH 키 복사¶

공개 키를 원격 머신으로 복사합니다(비밀번호는 한 번만 입력):

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

3단계: Gateway(게이트웨이) 토큰 설정¶

launchctl setenv OPENCLAW_GATEWAY_TOKEN "<your-token>"

4단계: SSH 터널 시작¶

ssh -N remote-gateway &

5단계: OpenClaw.app 재시작¶

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

이제 앱은 SSH 터널을 통해 원격 Gateway(게이트웨이)에 연결됩니다.

로그인 시 터널 자동 시작¶

로그인할 때 SSH 터널이 자동으로 시작되도록 하려면 Launch Agent를 생성하십시오.

PLIST 파일 생성¶

다음을 ~/Library/LaunchAgents/bot.molt.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>bot.molt.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/bot.molt.ssh-tunnel.plist

이제 터널은 다음을 수행합니다:

• 로그인 시 자동 시작
• 크래시 발생 시 재시작
• 백그라운드에서 계속 실행

레거시 참고 사항: 존재하는 경우 남아 있는 com.openclaw.ssh-tunnel LaunchAgent를 제거하십시오.

문제 해결¶

터널 실행 여부 확인:

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

터널 재시작:

launchctl kickstart -k gui/$UID/bot.molt.ssh-tunnel

터널 중지:

launchctl bootout gui/$UID/bot.molt.ssh-tunnel

작동 방식¶

OpenClaw.app은 클라이언트 머신의 ws://127.0.0.1:18789에 연결합니다. SSH 터널은 해당 연결을 Gateway(게이트웨이)가 실행 중인 원격 머신의 포트 18789로 포워딩합니다.