📝 Ubuntu 서버에서 OpenClaw Gateway를 원격에서 접속 가능하게 만드는 방법

OpenClaw는 기본적으로 로컬(127.0.0.1) 에서만 Web UI(Gateway)를 열도록 설계되어 있다.
이는 보안상 안전하지만, 실제로는 다른 PC나 모바일에서도 접속하고 싶을 때가 많다.

이 글에서는 Ubuntu 서버에 설치된 OpenClaw Gateway를
LAN 또는 외부 인터넷에서 접속 가능하게 만드는 방법을 정리한다.

1. 기본 구조 이해하기

OpenClaw는 다음과 같은 구조로 동작한다.

Dashboard (Web UI)
Gateway (WebSocket + API)
Agent (작업 실행기)

여기서 Gateway는 기본적으로 아래 주소에서만 열린다.

http://127.0.0.1:18789

즉, 서버 내부에서만 접근 가능하다.

원격에서 접속하려면 다음 중 하나를 선택해야 한다.

  • SSH 터널링 (가장 안전)
  • Nginx Reverse Proxy (가장 편리)
  • Gateway 설정에서 origin 허용 추가

아래에서 각각의 방법을 설명한다.

2. 방법 1 — SSH 터널링 (보안 최강)

원격 PC에서 아래 명령 실행:

ssh -N -L 18789:127.0.0.1:18789 user@서버IP

예:

ssh -N -L 18789:127.0.0.1:18789 user@192.168.0.xx (Openclaw 가 실행중인 IP)

그리고 브라우저에서:

http://127.0.0.1:18789

이 방식은 Gateway를 외부에 노출하지 않고도
안전하게 원격 접속할 수 있는 가장 권장되는 방법이다.

3. 방법 2 — Gateway에 원격 Origin 허용 추가

OpenClaw Gateway는 보안상 origin(접속 출처) 를 제한한다.
원격 접속을 허용하려면 서버에서 아래 명령을 실행한다.
Local 의 openclaw gateway WebUI 에서 token 확인.

3-1. 원격 접속 Origin 허용

예: LAN 전체 허용

openclaw gateway allow-origin http://192.168.0.21:18789
openclaw gateway allow-origin http://localhost:18789
openclaw gateway allow-origin http://127.0.0.1:18789

외부 도메인을 사용할 경우:

openclaw gateway allow-origin https://your-domain.com

3-2. Gateway 재시작

openclaw gateway restart

이제 LAN 또는 도메인에서 바로 접속할 수 있다.

4. 방법 3 — Nginx Reverse Proxy로 외부 접속 허용 (가장 편리)

OpenClaw Gateway를 외부에서 쉽게 접속하려면
Nginx Reverse Proxy를 사용하는 것이 가장 깔끔하다.

4-1. Nginx 설치

sudo apt install nginx

4-2. 설정 파일 생성

sudo nano /etc/nginx/sites-available/openclaw

아래 내용 입력:

server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://127.0.0.1:18789/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

4-3. 활성화

sudo ln -s /etc/nginx/sites-available/openclaw /etc/nginx/sites-enabled/
sudo systemctl restart nginx

4-4. 접속

http://your-domain.com

원한다면 Let’s Encrypt로 HTTPS도 적용할 수 있다.

 

티스토리툴바