ClawHost로 OpenClaw를 단 1분 만에 VPS에 배포하는 방법과 아키텍처 완전 정리

ClawHost는 OpenClaw를 전용 VPS에 클릭 한 번으로 배포할 수 있도록 설계된 오픈소스 클라우드 호스팅 플랫폼입니다. 서버 프로비저닝부터 DNS, SSL, 방화벽 설정, OpenClaw 설치까지 전 과정을 자동화해 인프라 운영 부담을 최소화합니다.

이 글에서는 ClawHost의 개념과 구조, 주요 기능, 기술 스택, 셀프 호스팅 방법, 실제 동작 방식까지 체계적으로 정리합니다. 또한 어떤 점에서 차별화되는지, 어떻게 활용할 수 있는지 구체적으로 살펴보겠습니다.

반응형

---

ClawHost란 무엇인가

ClawHost는 OpenClaw를 전용 VPS 환경에 자동으로 배포해주는 셀프 호스팅 기반 클라우드 플랫폼입니다. 단순한 설치 스크립트가 아니라, 서버 생성부터 네트워크 설정, 보안 구성까지 전 과정을 통합 관리합니다.

핵심 개념

• 전용 VPS 기반 배포 (공유 컨테이너 아님)
• 완전 자동화된 인프라 구성
• 오픈소스(MIT 라이선스)
• 전체 플랫폼 자체 호스팅 가능

즉, AI 사용에 집중하고 인프라 운영은 자동화하고 싶은 사용자를 위한 플랫폼입니다.

---

ClawHost 주요 특징

1. 원클릭 배포

서버 선택 → 결제 → 자동 배포
몇 분 이내에 OpenClaw가 실행 상태로 준비됩니다.

2. 전용 VPS 제공

공유 환경이 아닌 실제 VPS 서버에 루트 권한으로 접근 가능합니다.
완전한 제어권과 독립 리소스를 제공합니다.

3. 자동 SSL 구성

Let's Encrypt 기반 HTTPS가 자동 설정됩니다.
별도의 인증서 발급 과정이 필요 없습니다.

4. DNS 자동 관리

Cloudflare API를 통해 서브도메인을 자동 생성합니다.
예: abc1234.yourdomain.com 형태

5. 글로벌 서버 위치

미국, 유럽, 아시아 등 총 6개 리전을 지원합니다.

6. SSH 키 관리

비밀번호 없는 접근을 위한 SSH 키 저장 및 할당 기능을 제공합니다.

7. 지속 스토리지 지원

추가 볼륨을 인스턴스에 연결하여 확장 가능합니다.

8. 비밀번호 없는 인증

Firebase 기반 매직 링크 로그인 방식으로 보안을 강화했습니다.

9. 내장 과금 시스템

Polar.sh 연동을 통해 구독 및 청구 관리가 가능합니다.

10. 완전 오픈소스

플랫폼 전체를 직접 셀프 호스팅할 수 있습니다.

---

아키텍처 구조

ClawHost는 TypeScript 기반 모노레포 구조로 구성되어 있습니다.

디렉토리 구조

• apps/api – Hono.js 기반 백엔드 API
• apps/web – React + Vite 기반 프론트엔드
• packages/shared – HTTP 클라이언트 유틸
• packages/i18n – 국제화 모듈
• scripts/cloud-init.yaml – 서버 초기화 템플릿
• turbo.json – Turborepo 빌드 관리
• pnpm-workspace.yaml – 워크스페이스 정의

모노레포 환경은 코드 재사용성과 유지보수 효율성을 높입니다.

---

기술 스택 분석

레이어	기술
API	Hono on Node.js
DB	PostgreSQL + Drizzle ORM
인증	Firebase (Passwordless)
서버 프로비저닝	Hetzner Cloud API
DNS	Cloudflare API
결제	Polar.sh
이메일	Resend + React Email
프론트엔드	React 18 + Vite
UI	shadcn/ui + Radix UI + Tailwind CSS
상태 관리	Zustand
데이터 패칭	TanStack React Query
모노레포	Turborepo + pnpm

각 영역이 명확히 분리되어 있어 확장성과 유지보수성이 뛰어납니다.

---

ClawHost 동작 방식

사용자가 새로운 인스턴스를 생성하면 다음 순서로 진행됩니다.

1. 결제 생성
   Polar.sh 구독 생성
2. 서버 프로비저닝
   Hetzner Cloud VPS 자동 생성
3. cloud-init 실행
   Node.js 22
   OpenClaw 설치
   Nginx 설정
   SSL 인증서 발급
   UFW 방화벽 구성
   systemd 자동 실행 설정
4. DNS 구성
   Cloudflare에 서브도메인 자동 생성
5. 접근 정보 제공
   서브도메인 URL
   루트 비밀번호
   SSH 접근 정보 전달

즉, 사용자는 인프라 설정 없이 바로 OpenClaw를 사용할 수 있습니다.

---

셀프 호스팅 방법 요약

사전 요구사항

• Node.js 20+
• pnpm 9.14+
• PostgreSQL 데이터베이스

1. 저장소 클론 및 설치

git clone https://github.com/bfzli/clawhost.git
cd clawhost
pnpm install

2. 환경 변수 설정

apps/api/.env
DATABASE_URL, Firebase, Hetzner, Cloudflare, Polar 설정

apps/web/.env
Firebase Client SDK 설정

3. 외부 서비스 설정

• Hetzner Cloud API 토큰 생성
• Firebase 이메일 링크 인증 활성화
• Cloudflare Zone ID 및 API 토큰 설정
• Polar.sh 웹훅 구성

4. 데이터베이스 초기화

pnpm --filter api db:migrate

5. 개발 서버 실행

pnpm dev

웹과 API 서버가 동시에 실행됩니다.

---

배포 전략

웹 앱

정적 SPA로 빌드되어 다음 환경에 배포 가능합니다.

• Vercel
• Cloudflare Pages
• Netlify
• Nginx / Apache

pnpm build

API 서버

Next.js 애플리케이션 위에 Hono가 마운트되어 있습니다.

cd apps/api
pnpm build
pnpm start

---

커스터마이징 포인트

서브도메인 패턴 변경

Cloudflare 설정 및 cloud-init 템플릿 수정

가격 마진 조정

Hetzner 기본 가격 대비 마크업 설정 가능

cloud-init 수정

Node.js 버전 변경
추가 패키지 설치
추가 서비스 설정 가능

국제화 지원

@openclaw/i18n을 통해 다국어 UI 확장 가능

---

문제 해결 가이드 핵심 요약

SSL 문제

서버 부팅 후 1~2분 소요
포트 80, 443 열려 있는지 확인

DNS 전파 지연

1~5분 대기
Cloudflare API 권한 확인

Firebase 인증 오류

• Authorized domains 등록 여부 확인
• 이메일 링크 로그인 활성화 여부 확인
• 환경 변수 일치 여부 확인

데이터베이스 연결 오류

• DATABASE_URL 확인
• db:migrate 실행 여부 확인
• db:studio로 직접 점검

---

728x90

ClawHost는 단순한 배포 도구가 아니라, OpenClaw 운영을 위한 자동화된 클라우드 플랫폼입니다. 인프라 자동화, 보안 설정, DNS 구성, 과금 시스템까지 통합되어 있어 서비스형 AI 환경을 빠르게 구축할 수 있습니다.

특히 다음과 같은 사용자에게 적합합니다.

• AI 인프라를 직접 통제하고 싶은 개발자
• SaaS 형태로 OpenClaw를 운영하려는 팀
• 인프라 관리 시간을 줄이고 싶은 운영자

완전 오픈소스 기반이라는 점은 확장성과 투명성 측면에서 큰 강점입니다.
앞으로 AI 기반 서비스가 확산될수록, 자동화된 전용 VPS 배포 플랫폼의 수요는 더욱 증가할 것으로 기대됩니다.

ClawHost는 그 시작점이 될 수 있는 실질적인 대안입니다.

300x250

https://github.com/bfzli/clawhost?fbclid=IwY2xjawP9UC1leHRuA2FlbQIxMABicmlkETFabHkyYUZ2SFhiQzVkNlR3c3J0YwZhcHBfaWQQMjIyMDM5MTc4ODIwMDg5MgABHv5h_wcrAiTismkRWmGKhasYaE0nEbx7UkI45FBihSUw5Fo_ypA8J_VElzZW_aem_kEbXQwoPrZ3eFwD0niu_Sw

GitHub - bfzli/clawhost: Deploy OpenClaw. One click. Done.