콘텐츠로 이동

DigitalOcean에서 OpenClaw Gateway 실행하기

서버를 직접 구축하려고 하면 항상 비용과 설정의 복잡함 사이에서 고민하게 됩니다. 무료 티어는 사양이 너무 낮거나 설정이 까다롭고, 고사양 서버를 쓰기에는 매달 나가는 비용이 부담스럽죠. 안정적이면서도 관리가 쉬운 환경에서 나만의 서비스를 운영하고 싶은 개발자들에게 DigitalOcean은 아주 합리적인 선택지입니다.

이 가이드에서는 월 6달러(예약 요금제 사용 시 월 4달러)로 DigitalOcean에서 OpenClaw Gateway를 안정적으로 운영하는 방법을 설명할게요.

시작하기 전에 다음 항목들이 준비되었는지 확인해 주세요.

  1. DigitalOcean에 로그인하세요.
  2. Create → Droplets를 클릭합니다.
  3. 다음 옵션을 선택하세요:
    • Region: 자신이나 사용자와 가장 가까운 지역
    • Image: Ubuntu 24.04 LTS
    • Size: Basic → Regular → $6/mo (1 vCPU, 1GB RAM, 25GB SSD)
    • Authentication: SSH key (권장) 또는 password
  4. Create Droplet을 클릭합니다.
  5. 생성된 서버의 IP 주소를 확인하세요.

터미널을 열고 서버에 접속합니다.

Terminal window
ssh root@YOUR_DROPLET_IP

서버에 접속했다면 다음 명령어를 순서대로 입력해서 Node.js와 OpenClaw를 설치하세요.

Terminal window
# 시스템 업데이트
apt update && apt upgrade -y
# Node.js 22 설치
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
apt install -y nodejs
# OpenClaw 설치
curl -fsSL https://openclaw.ai/install.sh | bash
# 설치 확인
openclaw --version

이제 설정을 마무리할 차례입니다.

Terminal window
openclaw onboard --install-daemon

설정 마법사가 다음 과정을 안내해 줍니다:

  • 모델 인증 (API keys 또는 OAuth)
  • 채널 설정 (Telegram, WhatsApp, Discord 등)
  • Gateway 토큰 (자동 생성)
  • 데몬 설치 (systemd)

설정이 끝났다면 서비스가 잘 돌아가고 있는지 확인해 보세요.

Terminal window
# 상태 확인
openclaw status
# 서비스 상태 확인
systemctl --user status openclaw-gateway.service
# 로그 확인
journalctl --user -u openclaw-gateway.service -f

Gateway는 기본적으로 로컬호스트에 바인딩됩니다. 제어 UI에 접속하는 방법은 세 가지가 있어요.

방법 A: SSH 터널링 (권장)

로컬 컴퓨터의 터미널에서 다음 명령어를 실행하세요.

Terminal window
ssh -L 18789:localhost:18789 root@YOUR_DROPLET_IP

그다음 브라우저에서 http://localhost:18789를 열면 됩니다.

방법 B: Tailscale Serve (HTTPS 사용)

Terminal window
# Droplet에서 실행
curl -fsSL https://tailscale.com/install.sh | sh
tailscale up
# Gateway가 Tailscale Serve를 사용하도록 설정
openclaw config set gateway.tailscale.mode serve
openclaw gateway restart

이제 https://<magicdns>/로 접속할 수 있습니다.

방법 C: Tailnet 바인딩 (Serve 미사용)

Terminal window
openclaw config set gateway.bind tailnet
openclaw gateway restart

http://<tailscale-ip>:18789로 접속하세요 (토큰이 필요합니다).

사용할 메신저 채널을 연결하세요.

Telegram

Terminal window
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

WhatsApp

Terminal window
openclaw channels login whatsapp
# 화면에 나오는 QR 코드를 스캔하세요

월 6달러 플랜은 RAM이 1GB로 적은 편입니다. 원활한 운영을 위해 다음 설정을 추천해요.

Terminal window
fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab

메모리 부족(OOM) 현상이 발생한다면 다음을 고려해 보세요.

  • 로컬 모델 대신 API 기반 모델(Claude, GPT) 사용
  • agents.defaults.model.primary 설정을 더 작은 모델로 변경

문제가 생겼을 때는 다음 명령어들로 원인을 파악할 수 있습니다.

Gateway가 시작되지 않을 때

Terminal window
openclaw gateway status
openclaw doctor --non-interactive
journalctl -u openclaw --no-pager -n 50

포트가 이미 사용 중일 때

Terminal window
lsof -i :18789
kill <PID>

메모리가 부족할 때

Terminal window
# 메모리 확인
free -h
# Swap을 더 추가하거나 $12/mo 플랜(2GB RAM)으로 업그레이드하세요.

설정 중에 막히는 부분이 있나요? AI Setup Assistant에게 물어보면 바로 도움을 받을 수 있습니다.

OpenClaw

OpenClaw Expert

아직 막혀 있나요?

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