Hosting

DigitalOcean

DigitalOcean Droplet에서 지속 실행되는 OpenClaw Gateway를 실행합니다(1 GB Basic 플랜 기준 약 $6/월).

DigitalOcean은 가장 간단한 유료 VPS 경로입니다. 더 저렴하거나 무료 옵션을 선호한다면:

  • Hetzner — €3.79/월, 달러당 더 많은 코어/RAM.
  • Oracle Cloud — Always Free ARM(최대 4 OCPU, 24 GB RAM), 하지만 가입이 까다로울 수 있고 ARM 전용입니다.

사전 요구 사항

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

설정

  • Droplet 만들기

    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 키(권장) 또는 비밀번호
    4. Create Droplet을 클릭하고 IP 주소를 기록합니다.
  • 연결 및 설치

    ssh root@YOUR_DROPLET_IP
    
    apt update && apt upgrade -y
    
    # Install Node.js 24
    curl -fsSL https://deb.nodesource.com/setup_24.x | bash -
    apt install -y nodejs
    
    # Install OpenClaw
    curl -fsSL https://openclaw.ai/install.sh | bash
    openclaw --version
    
  • 온보딩 실행

    openclaw onboard --install-daemon
    

    마법사가 모델 인증, 채널 설정, Gateway 토큰 생성, 데몬 설치(systemd)를 안내합니다.

  • 스왑 추가(1 GB Droplet에 권장)

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

    openclaw status
    systemctl --user status openclaw-gateway.service
    journalctl --user -u openclaw-gateway.service -f
    
  • 제어 UI에 액세스

    Gateway는 기본적으로 루프백에 바인드됩니다. 다음 옵션 중 하나를 선택하세요.

    옵션 A: SSH 터널(가장 간단함)

    # From your local machine
    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>/를 엽니다.

    Tailscale Serve는 tailnet ID 헤더를 통해 제어 UI와 WebSocket 트래픽을 인증하며, 이는 Gateway 호스트 자체를 신뢰한다고 가정합니다. HTTP API 엔드포인트는 이와 관계없이 Gateway의 일반 인증 모드(토큰/비밀번호)를 따릅니다. Serve를 통해 명시적인 공유 시크릿 자격 증명을 요구하려면 gateway.auth.allowTailscale: false를 설정하고 gateway.auth.mode: "token" 또는 "password"를 사용하세요.

    옵션 C: Tailnet 바인드(Serve 없음)

    openclaw config set gateway.bind tailnet
    openclaw gateway restart
    

    그런 다음 http://<tailscale-ip>:18789를 엽니다(토큰 필요).

  • 지속성 및 백업

    OpenClaw 상태는 다음 위치에 저장됩니다:

    • ~/.openclaw/openclaw.json, 에이전트별 auth-profiles.json, 채널/프로바이더 상태, 세션 데이터.
    • ~/.openclaw/workspace/ — 에이전트 워크스페이스(SOUL.md, 메모리, 아티팩트).

    이 데이터는 Droplet 재부팅 후에도 유지됩니다. 이식 가능한 스냅샷을 만들려면:

    openclaw backup create
    

    DigitalOcean 스냅샷은 전체 Droplet을 백업합니다. openclaw backup create는 호스트 간에 이식 가능합니다.

    1 GB RAM 팁

    $6 Droplet에는 RAM이 1 GB뿐입니다. 원활하게 유지하려면:

    • 위의 스왑 단계가 재부팅 후에도 유지되도록 /etc/fstab에 들어 있는지 확인하세요.
    • 로컬 모델보다 API 기반 모델(Claude, GPT)을 선호하세요. 로컬 LLM 추론은 1 GB에 맞지 않습니다.
    • 큰 프롬프트에서 OOM이 발생하면 agents.defaults.model.primary를 더 작은 모델로 설정하세요.
    • free -hhtop으로 모니터링하세요.

    문제 해결

    Gateway가 시작되지 않음 -- openclaw doctor --non-interactive를 실행하고 journalctl --user -u openclaw-gateway.service -n 50로 로그를 확인하세요.

    포트가 이미 사용 중임 -- lsof -i :18789를 실행해 프로세스를 찾은 다음 중지하세요.

    메모리 부족 -- free -h로 스왑이 활성화되어 있는지 확인하세요. 그래도 OOM이 발생하면 로컬 모델 대신 API 기반 모델(Claude, GPT)을 사용하거나 2 GB Droplet으로 업그레이드하세요.

    다음 단계

    관련 항목