메모

Hostinger VPS에 OpenClaw 설치 및 초기 설정 완벽 가이드

KING

— 9 min read
Hostinger VPS에 OpenClaw 설치 및 초기 설정 완벽 가이드
📝 Memos에서 자동 발행됨
🕐 작성일: 2026-02-09
✨ AI가 보충 설명을 추가했습니다

기술 블로그 작가로서, 제공해주신 메모를 분석하여 독자들이 Hostinger VPS에 OpenClaw를 설치하고 초기 설정하는 과정을 더욱 명확하게 이해할 수 있도록 블로그 포스트를 구성했습니다.

Hostinger VPS에 OpenClaw 설치 및 초기 설정 완벽 가이드

## 개요

이 가이드는 Hostinger VPS 서버를 임대하여 Ubuntu 운영체제를 구축하고, Docker 환경 위에서 OpenClaw 애플리케이션을 성공적으로 설치 및 초기 설정하는 과정을 단계별로 안내합니다. 서버 임대부터 OpenClaw 실행에 이르기까지 필요한 주요 작업들을 정리하여, 독자들이 쉽고 빠르게 자신만의 OpenClaw 서버를 구축할 수 있도록 돕는 것을 목표로 합니다.

## 상세 가이드

원본 메모의 내용을 바탕으로 각 단계에 필요한 추가 설명을 덧붙였습니다.

  1. Hostinger VPS 서버 임대 및 기본 접속 준비
    • 설명: Hostinger 웹사이트를 통해 원하는 사양의 VPS 서버를 선택하고 임대하는 과정입니다. 임대 후에는 Hostinger에서 제공하는 SSH 접속 정보(IP 주소, 사용자 이름, 비밀번호 또는 SSH 키)를 사용하여 서버에 원격으로 접속할 준비를 합니다. SSH 클라이언트(예: PuTTY, 터미널)를 이용하여 서버에 처음 접속하게 됩니다.
  2. Ubuntu 운영체제 초기 설정 및 시스템 업데이트
    • 설명: VPS에 설치된 Ubuntu 운영체제에 접속한 후, 가장 먼저 시스템을 최신 상태로 업데이트하고 필수 도구를 설치하는 것이 중요합니다. 이는 보안을 강화하고 향후 발생할 수 있는 호환성 문제를 예방하는 데 도움이 됩니다.
  3. Docker 및 Docker Compose 설치
    • 설명: OpenClaw는 Docker 컨테이너 환경에서 실행되는 경우가 많습니다. 따라서 Ubuntu 서버에 Docker와 Docker Compose를 설치하여 컨테이너 관리 환경을 구축합니다.
  4. OpenClaw 설치 및 실행 (Docker 활용)
    • 설명: OpenClaw의 공식 문서를 참조하여 Docker 또는 Docker Compose를 이용해 OpenClaw를 설치하고 실행합니다. 일반적으로 Docker Hub에서 OpenClaw 이미지를 풀(pull)받아 컨테이너를 생성하고 실행하는 방식입니다.
  5. OpenClaw 초기 설정 및 서비스 확인
    • 설명: OpenClaw 컨테이너가 성공적으로 실행된 후, 웹 브라우저를 통해 VPS의 IP 주소 또는 도메인으로 접속하여 OpenClaw의 초기 설정 마법사를 완료하거나, 필요한 경우 설정 파일을 추가로 편집합니다.
      • 웹 브라우저에서 http://[VPS_IP_주소] 또는 http://[도메인]으로 접속합니다.
      • OpenClaw의 초기 설정 화면이 나타나면 안내에 따라 관리자 계정 생성, 데이터베이스 설정, 기타 초기 환경 설정을 진행합니다.
      • 모든 설정이 완료되면 OpenClaw 서비스가 정상적으로 동작하는지 확인하고, 필요에 따라 추가적인 구성을 진행합니다.

컨테이너가 정상적으로 실행되는지 확인합니다.

docker ps

docker-compose.yml 파일 작성을 완료했다면, 다음 명령어를 통해 OpenClaw 컨테이너를 실행합니다.

docker compose up -d

OpenClaw 공식 문서에서 제공하는 docker-compose.yml 파일을 다운로드하거나 직접 작성합니다. (예시: 실제 OpenClaw 설치 스크립트나 Docker Compose 파일은 OpenClaw 공식 GitHub 저장소나 문서에서 확인해야 합니다.)

# 예시 docker-compose.yml (실제 OpenClaw 설정과 다를 수 있음)
version: '3.8'
services:
openclaw:
image: openclaw/openclaw:latest # OpenClaw 공식 이미지 사용
container_name: openclaw_app
ports:
  - "80:80" # 웹 인터페이스 포트 (필요에 따라 변경)
volumes:
  - ./data:/app/data # 데이터 영속성을 위한 볼륨 마운트
environment:
  - PUID=1000
  - PGID=1000
  # 기타 OpenClaw 설정 변수
restart: unless-stopped

OpenClaw를 위한 디렉토리를 생성하고 이동합니다.

mkdir ~/openclaw
cd ~/openclaw

설치 확인

docker --version
docker compose version # 또는 docker-compose --version

Docker Compose를 설치합니다. (최신 버전은 Docker 공식 문서에서 확인)

sudo curl -L "https://github.com/docker/compose/releases/download/v2.24.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
# 또는 최신 버전 설치 방법:
# sudo apt install docker-compose-plugin -y

현재 사용자를 docker 그룹에 추가하여 sudo 없이 Docker 명령어를 사용할 수 있도록 설정합니다. (적용을 위해 재로그인 필요)

sudo usermod -aG docker ${USER}

새롭게 추가된 저장소의 패키지 목록을 업데이트하고 Docker Engine을 설치합니다.

sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io -y

Docker stable 저장소를 추가합니다.

echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Docker 공식 GPG 키를 추가합니다.

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

Docker를 설치하기 위한 필수 패키지를 설치합니다.

sudo apt install apt-transport-https ca-certificates curl software-properties-common -y

기본적인 방화벽(UFW)을 설정하여 불필요한 포트 접근을 차단하고 보안을 강화합니다. SSH 포트(기본 22번) 및 OpenClaw에서 사용할 포트(예: 80, 443, 또는 특정 포트)를 허용합니다.

sudo apt install ufw -y
sudo ufw allow ssh
# OpenClaw가 웹 서비스인 경우 HTTP/HTTPS 포트 허용
sudo ufw allow http
sudo ufw allow https
# 또는 특정 포트를 사용할 경우
# sudo ufw allow 8080/tcp
sudo ufw enable
sudo ufw status

SSH 접속 후 다음 명령어를 실행하여 패키지 목록을 업데이트하고 기존 패키지를 업그레이드합니다.

sudo apt update
sudo apt upgrade -y

## 💡 유용한 팁

  • SSH 키 인증 사용: 비밀번호 방식보다 SSH 키를 사용하여 서버에 접속하는 것이 훨씬 안전합니다. Hostinger 패널에서 SSH 키를 설정하고 사용하는 방법을 익히세요.
  • 백업 생활화: 중요한 데이터 손실을 방지하기 위해 정기적으로 OpenClaw 데이터(마운트된 볼륨)와 VPS 전체 스냅샷을 백업하는 습관을 들이세요.
  • 도메인 연결: VPS IP 주소 대신 기억하기 쉬운 도메인 이름을 연결하여 서비스 접근성을 높이세요. Hostinger에서 도메인 및 DNS 설정을 쉽게 관리할 수 있습니다.
  • Docker Compose 활용: 여러 개의 Docker 컨테이너를 함께 관리해야 할 경우, docker-compose.yml 파일을 사용하여 서비스 정의, 네트워크 설정, 볼륨 관리를 한 번에 할 수 있어 매우 효율적입니다.
  • 로그 확인: 문제가 발생했을 때 docker logs [컨테이너_이름] 명령어를 사용하여 OpenClaw 컨테이너의 로그를 확인하면 문제 해결에 큰 도움이 됩니다.

## ⚠️ 주의사항

  • 보안 설정: VPS는 항상 인터넷에 노출되어 있으므로, SSH 포트 변경, 강력한 비밀번호 또는 SSH 키 사용, UFW 방화벽 설정 등을 통해 기본적인 보안을 철저히 해야 합니다.
  • 리소스 부족: OpenClaw의 요구사항에 비해 VPS 사양이 너무 낮으면 성능 저하 또는 서비스 불안정 문제가 발생할 수 있습니다. OpenClaw의 권장 사양을 확인하고 충분한 리소스(CPU, RAM, 디스크 공간)를 확보하세요.
  • 포트 충돌: Docker 컨테이너가 호스트 서버의 이미 사용 중인 포트와 동일한 포트를 사용하려고 하면 충돌이 발생하여 컨테이너가 시작되지 않을 수 있습니다. docker ps 명령어로 사용 중인 포트를 확인하고 OpenClaw 설정 시 포트 번호를 적절히 조정해야 합니다.
  • 데이터 영속성: Docker 컨테이너는 휘발성이므로, volumes 설정을 통해 호스트 서버의 디렉토리에 데이터를 마운트(persist)하여 컨테이너가 삭제되거나 재생성되어도 데이터가 유지되도록 반드시 설정해야 합니다.

## 🔗 참고 자료

원본 메모에 특정 링크는 없었지만, 다음 유형의 자료들이 OpenClaw 설치에 매우 유용합니다.

  • Hostinger 공식 문서: VPS 서버 임대, SSH 접속, 방화벽 설정 등 Hostinger 관련 공식 가이드
  • Ubuntu 공식 문서: 기본적인 서버 관리, 패키지 설치 등 Ubuntu 운영체제 관련 정보
  • Docker 공식 문서: Docker Engine 및 Docker Compose 설치 및 사용법
  • OpenClaw 공식 GitHub 저장소 또는 문서: OpenClaw의 최신 설치 방법, Docker Compose 예시, 환경 변수 설정 등 상세한 정보
  • UFW 방화벽 공식 문서: UFW(Uncomplicated Firewall) 설정 및 사용법

Read more

개인정보보호링크