메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.kr/llms.txt

Use this file to discover all available pages before exploring further.

​
DigitalOcean

DigitalOcean Droplet에서 지속적으로 실행되는 OpenClaw Gateway를 운영합니다.

​
필요 조건

  • DigitalOcean 계정 (signup)
  • SSH 키 쌍 (또는 비밀번호 인증 사용 의사)
  • 약 20분

​
설정

1

Droplet 만들기

깨끗한 베이스 이미지(Ubuntu 24.04 LTS)를 사용하세요. 시작 스크립트와 기본 방화벽 설정을 직접 검토하지 않았다면 서드파티 Marketplace 1-click 이미지는 피하는 편이 안전합니다.
  1. DigitalOcean에 로그인합니다.
  2. Create > Droplets를 클릭합니다.
  3. 다음처럼 선택합니다:
    • Region: 본인과 가장 가까운 리전
    • Image: Ubuntu 24.04 LTS
    • Size: Basic, Regular, 1 vCPU / 1 GB RAM / 25 GB SSD
    • Authentication: SSH key 권장, 또는 password
  4. Create Droplet를 클릭하고 IP 주소를 기록합니다.
2

접속 후 설치

ssh root@YOUR_DROPLET_IP

apt update && apt upgrade -y

# Node.js 24 설치
curl -fsSL https://deb.nodesource.com/setup_24.x | bash -
apt install -y nodejs

# OpenClaw 설치
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw --version
3

온보딩 실행

openclaw onboard --install-daemon
이 마법사는 모델 인증, 채널 설정, gateway 토큰 생성, 데몬 설치(systemd)를 순서대로 안내합니다.
4

스왑 추가 (1 GB Droplet 권장)

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

Gateway 확인

openclaw status
systemctl --user status openclaw-gateway.service
journalctl --user -u openclaw-gateway.service -f
6

Control UI 접속

Gateway는 기본적으로 loopback에 바인드됩니다. 아래 방법 중 하나를 고르세요.옵션 A: SSH 터널 (가장 단순함)
# 로컬 머신에서 실행
ssh -L 18789:localhost:18789 root@YOUR_DROPLET_IP
그런 다음 http://localhost:18789를 엽니다.옵션 B: Tailscale Serve
curl -fsSL https://tailscale.com/install.sh | sh
tailscale up
openclaw config set gateway.tailscale.mode serve
openclaw gateway restart
그다음 tailnet에 연결된 아무 기기에서나 https://<magicdns>/를 엽니다.옵션 C: Tailnet bind (Serve 없이)
openclaw config set gateway.bind tailnet
openclaw gateway restart
그다음 http://<tailscale-ip>:18789에 접속합니다 (토큰 필요).

​
문제 해결

Gateway가 시작되지 않음: openclaw doctor --non-interactive를 실행하고 journalctl --user -u openclaw-gateway.service -n 50로 로그를 확인하세요. 포트가 이미 사용 중임: lsof -i :18789로 프로세스를 찾은 뒤 중지하세요. 메모리 부족: free -h로 swap이 활성화됐는지 확인하세요. 계속 OOM이 난다면 로컬 모델 대신 API 기반 모델(Claude, GPT)을 쓰거나 2 GB Droplet로 올리세요.

​
다음 단계