APIYI에서 전해드립니다: OpenClaw는 지속적으로 실행되어야 하는 AI Agent입니다. 일반적인 채팅 도구와 달리 WhatsApp, Telegram, Discord 등과 실시간 WebSocket 연결을 유지하고, 예약된 작업을 수행하며, 세션 간 기억을 보존해야 합니다. 이 모든 것을 위해 Gateway 프로세스가 24시간 내내 온라인 상태여야 하죠.
여기서 핵심적인 질문이 생깁니다. OpenClaw를 로컬 컴퓨터에서 실행해야 할까요, 아니면 클라우드 서버에서 실행해야 할까요?
정답은 여러분의 사용 환경, 예산, 그리고 기술적 배경에 따라 달라집니다. 본문에서는 비용, 안정성, 개인정보 보호, 사용 편의성이라는 4가지 관점에서 Mac Mini 로컬 배포, VPS 클라우드 서버, 라즈베리 파이, 1Panel/Baota 패널 등 4가지 주요 배포 방식을 비교하여 여러분에게 가장 적합한 방법을 제안해 드립니다.
배포 방식별 비교 표는 다음과 같습니다:
| 배포 방식 | 초기 비용 | 월 비용 | 24/7 안정성 | 기술 진입 장벽 |
|---|---|---|---|---|
| Mac Mini 로컬 | ¥4,000-8,000 | API 비용 + 전기료 약 ¥10 | 가정용 네트워크 의존 | 낮음 |
| VPS 클라우드 서버 | ¥0 | 월 ¥25-150 + API 비용 | 데이터 센터급 | 중간 |
| 라즈베리 파이 | ¥400-600 | API 비용 + 전기료 약 ¥7 | 가정용 네트워크 의존 | 중간 |
| 1Panel/Baota 패널 | ¥0 | VPS 비용 + API 비용 | 데이터 센터급 | 낮음 |
🚀 빠른 시작: 어떤 배포 방식을 선택하든 OpenClaw에는 AI 모델의 API 지원이 필요합니다. **APIYI(apiyi.com)**를 통해 Claude, GPT-4o 등 다양한 모델의 API 인터페이스를 한곳에서 이용할 수 있으며,
openclaw.json파일에 한 번만 설정하면 바로 사용할 수 있습니다.
왜 OpenClaw는 24시간 내내 실행되어야 할까요: Gateway 아키텍처 분석
배포 방안을 논의하기 전에 한 가지 핵심 개념을 이해해야 합니다. OpenClaw Gateway는 필요할 때만 켜는 도구가 아니라, 백그라운드에서 계속 실행되는 데몬(Daemon) 프로세스입니다.
OpenClaw Gateway의 3가지 상시 가동 필요성
1. 메시징 플랫폼과의 실시간 연결
OpenClaw는 WebSocket을 통해 각 메시징 플랫폼과 상시 연결을 유지합니다. Gateway가 중지되면 모든 메시지 채널이 즉시 끊어집니다.
| 플랫폼 | 연결 방식 | Gateway 중지 시 영향 |
|---|---|---|
| WebSocket (baileys) | 완전히 끊김, 메시지 송수신 불가 | |
| Telegram | Bot Token + Webhook | 메시지 지연(백로그), 재시작 후 복구 가능 |
| Discord | Bot Token + WebSocket | 끊김, 재시작 후 자동 재연결 |
| Slack | Bot Token + Events API | 메시지 지연, 재시작 후 복구 가능 |
| iMessage | BlueBubbles (macOS 전용) | 끊김, macOS 기기가 온라인 상태여야 함 |
| Signal | WebSocket | 끊김, 메시지 유실 가능성 있음 |
이 중 WhatsApp은 특히 민감합니다. WhatsApp은 @whiskeysockets/baileys 라이브러리를 사용하여 WhatsApp Web 프로토콜을 구현하는데, Gateway가 WebSocket 연결 및 재연결 루프를 완전히 제어합니다. Gateway가 실행되지 않으면 WhatsApp 메시지를 보내거나 받을 수 없습니다.
2. 예약 작업 (Cron)
OpenClaw의 Cron 시스템은 Gateway 프로세스 내부에서 실행됩니다. 만약 "매일 아침 9시에 회의 알림 보내줘"라거나 "1시간마다 이메일을 확인해줘"와 같은 작업을 설정했다면, 이 작업들은 Gateway가 계속 실행 중일 때만 정해진 시간에 수행됩니다.
3. 지속적인 기억과 능동적 행동
OpenClaw는 SOUL.md와 MEMORY.md 파일을 통해 세션 간 기억을 유지합니다. 지속적으로 실행되는 에이전트는 컨텍스트 상태를 축적하여 진정한 능동적 행동을 구현할 수 있습니다. 즉, 사용자가 먼저 대화를 시작하지 않아도 에이전트가 스스로 상황을 모니터링하고, 스케줄을 관리하며 응답할 수 있게 됩니다.
방법 1: Mac Mini 로컬 배포 — OpenClaw 커뮤니티가 Mac Mini를 선호하는 이유
Mac Mini는 OpenClaw 커뮤니티에서 공인된 '레퍼런스 배포 기기'입니다. 창립자인 Peter Steinberger 본인도 Mac Mini를 주요 실행 환경으로 사용하고 있죠.
Mac Mini의 5가지 핵심 장점
| 장점 | 설명 |
|---|---|
| 초저전력 | 대기 상태에서 단 5-10W 소비, 월 전기료 약 2,000원 내외 |
| 충분한 성능 | Apple Silicon의 뛰어난 싱글 스레드 성능으로 Node.js가 빠르게 작동 |
| 로컬 모델 | 16-32GB 통합 메모리를 통해 Ollama로 로컬 대규모 언어 모델 실행 가능 |
| iMessage | BlueBubbles 통합을 통한 macOS 독점 기능 활용 가능 |
| 저소음 및 컴팩트 | 무팬 설계(M2/M4 모델)로 24/7 가동 시에도 소음 없음 |
Mac Mini 추천 사양
| 용도 | 추천 모델 | 메모리 | 예산 |
|---|---|---|---|
| 클라우드 모델 전용 | Mac Mini M2 | 8GB | 약 70만 원대 |
| 클라우드 + 로컬 모델 | Mac Mini M4 | 16GB | 약 90만 원대 |
| 헤비한 로컬 추론 | Mac Mini M4 Pro | 24-32GB | 150만 원 이상 |
Mac Mini 헤드리스(Headless) 운영 팁
Mac Mini를 OpenClaw 서버로 사용할 때는 모니터를 연결할 필요가 없지만, macOS는 가끔 모니터가 '연결된 상태'여야 정상 작동할 때가 있습니다. 해결 방법은 다음과 같습니다.
- HDMI 가상 디스플레이(더미 플러그): 약 5,000원 정도의 HDMI 가상 부하 장치를 꽂아 macOS가 모니터가 있는 것으로 인식하게 만듭니다.
- 절전 모드 해제: 시스템 설정 → 에너지 절약 → 디스플레이가 꺼져 있을 때 컴퓨터를 자동으로 잠자게 하지 않음 설정.
- 유선 네트워크: 안정적인 연결을 위해 WiFi 대신 이더넷 케이블을 사용하세요.
- 원격 접속: Tailscale 또는 macOS 내장 화면 공유 기능을 통해 관리합니다.
Mac Mini에 OpenClaw 설치하기
# Node.js 22+ 설치
brew install node@22
# OpenClaw 설치
npm install -g openclaw
# 설치 마법사 실행
openclaw onboard --install-daemon
# Gateway 시작
openclaw gateway start
# 상태 확인
openclaw status
설치 마법사가 Gateway를 시스템 데몬으로 자동 구성하여 부팅 시 자동 실행되도록 설정해 줍니다.
🎯 설정 제안: Mac Mini에 OpenClaw를 로컬 배포한 후, APIYI(apiyi.com)를 통해 AI 모델 인터페이스를 구성하는 것을 추천합니다. Claude와 GPT 두 모델을 한 번에 설정하여 다양한 작업 시나리오에 맞춰 활용해 보세요.
Mac Mini 배포의 한계
- 가정용 네트워크 의존: 인터넷이 끊기면 연결도 끊깁니다.
- 전력 의존: 정전 시 서비스가 중단됩니다.
- 로컬 네트워크 제한: 기본적으로 로컬에서만 접속 가능합니다(Tailscale로 해결 가능).
- 하드웨어 투자: 초기 비용이 약 70~150만 원 정도 발생합니다.
방법 2: VPS 클라우드 서버 배포 — 진정한 24/7 온라인 유지
OpenClaw의 메시지 채널이 절대 중단되지 않아야 한다면 VPS가 가장 안정적인 선택입니다. 데이터 센터급의 전력 및 네트워크 이중화로 진정한 의미의 7×24 가용성을 보장합니다.
VPS 서비스 제공업체 추천
| 업체명 | 최저 가격 | 특징 |
|---|---|---|
| Oracle Cloud | 무료 (4 ARM CPU + 24GB RAM) | 평생 무료 등급, 충분한 성능 |
| DigitalOcean | 월 $4-6 | 클릭 한 번으로 OpenClaw 이미지 생성 가능 |
| Hetzner | 월 $3-5 | 유럽 노드, 뛰어난 가성비 |
| Hostinger | 월 $5 | 클릭 한 번으로 OpenClaw VPS 템플릿 사용 가능 |
| 국내 클라우드 | 월 1~3만 원대 | 낮은 지연 시간, 빠른 고객 지원 |
VPS에 OpenClaw 배포하기 (Docker 방식)
# SSH로 서버 접속
ssh root@your-server-ip
# Docker 설치 (설치되지 않은 경우)
curl -fsSL https://get.docker.com | sh
# OpenClaw 클론
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# Docker Compose로 한 번에 실행
docker-compose up -d
# 로그 확인
docker-compose logs -f
VPS 배포 시 보안 핵심 요점
가장 중요한 점은 Gateway 포트를 절대 공용 인터넷에 노출하지 않는 것입니다.
{
"gateway": {
"bind": "127.0.0.1",
"port": 18789,
"auth": {
"token": "여러분의_보안_토큰"
}
}
}
bind를127.0.0.1로 설정하여 로컬 접속만 허용합니다.auth.token을 설정하여 인증 보호를 강화합니다.- 원격 접속 시에는 Tailscale을 사용하여 암호화된 터널을 구축하세요.
💡 팁: VPS에 배포된 OpenClaw는 iMessage를 지원하지 않습니다(macOS 하드웨어 필요). iMessage 기능이 꼭 필요하다면 Mac Mini 로컬 배포를 선택해야 합니다.
방법 3: 1Panel/바오타(Baota) 패널 배포 — 서버 관리의 문턱을 낮춘 최적의 솔루션
이미 서버를 보유하고 있고 1Panel이나 바오타(Baota) 패널을 사용 중이라면, 이 방법이 가장 간편합니다.
1Panel에서 OpenClaw 설치하기
1Panel 앱 스토어에는 OpenClaw가 이미 내장되어 있어 클릭 한 번으로 설치할 수 있습니다.
- 1Panel 관리 패널에 로그인합니다.
- 「앱 스토어」로 이동합니다.
- "OpenClaw"를 검색합니다.
- 설치를 클릭하고 Docker 컨테이너가 시작될 때까지 기다립니다.
- 컨테이너 설정에서
openclaw.json을 구성합니다.
1Panel용 Docker 이미지: 1panel/openclaw
바오타(Baota) 패널에서 OpenClaw 설치하기
바오타 패널에는 공식적인 OpenClaw 원클릭 설치 기능은 없지만, Docker 관리자를 통해 설치할 수 있습니다.
- 바오타 패널의 Docker 관리자 플러그인을 설치합니다.
- Docker Compose 프로젝트를 생성합니다.
- OpenClaw 공식
docker-compose.yml파일을 사용합니다. - 설정이 완료되면 컨테이너를 실행합니다.
openclaw.json을 통한 APIYI 모델 설정
1Panel이나 바오타 중 무엇을 사용하든 핵심 설정은 openclaw.json 파일에서 이루어집니다. 다음은 검증된 전체 설정 예시입니다.
{
"agents": {
"defaults": {
"model": {
"primary": "apiyi/claude-sonnet-4-6-20250514"
}
}
},
"models": {
"providers": {
"apiyi": {
"baseUrl": "https://api.apiyi.com/v1",
"apiKey": "sk-xxxxx당신의API키xxxxx",
"api": "openai-response",
"models": [
{
"id": "claude-sonnet-4-6-20250514",
"name": "Claude Sonnet 4.6"
},
{
"id": "gpt-4o",
"name": "GPT-4o"
}
]
}
}
},
"gateway": {
"bind": "127.0.0.1",
"port": 18789
}
}
설정 핵심 포인트 설명:
| 파라미터 | 설명 | 권장 값 |
|---|---|---|
agents.defaults.model.primary |
기본으로 사용할 모델 | apiyi/모델ID (provider명/모델명) |
models.providers.apiyi.baseUrl |
API 인터페이스 주소 | https://api.apiyi.com/v1 |
models.providers.apiyi.apiKey |
API 키 | APIYI 플랫폼에서 발급받은 키 |
models.providers.apiyi.api |
API 프로토콜 유형 | OpenAI 호환 시 openai-response 사용 |
gateway.bind |
리스닝 주소 | 127.0.0.1 (보안 권장) |
💰 비용 최적화:
openclaw.json에서 APIYI(apiyi.com)를 모델 제공자로 설정하면 Claude와 GPT 시리즈 모델을 동시에 사용할 수 있습니다. APIYI는 유연한 요금제를 제공하여 OpenClaw와 같이 장시간 실행되는 AI 에이전트 시나리오에 적합합니다.
설정을 수정한 후 OpenClaw Gateway는 대부분의 항목을 자동으로 핫 리로드(Hot Reload)하므로 수동으로 재시작할 필요가 없습니다. 다만, 게이트웨이 포트와 같은 인프라 설정을 변경한 경우에는 openclaw gateway restart를 실행해야 합니다.
설정이 올바른지 여부는 진단 명령어로 확인할 수 있습니다.
openclaw doctor
옵션 4: 라즈베리 파이 배포 — 초저비용 상시 가동 솔루션
예산이 한정되어 있지만 전용 OpenClaw 장비가 필요하다면 라즈베리 파이가 가장 경제적인 선택이에요.
라즈베리 파이 하드웨어 추천
| 하드웨어 | 권장 사양 | 가격 |
|---|---|---|
| 메인보드 | Raspberry Pi 5 (8GB) | 약 ¥500 |
| 스토리지 | 64GB 이상 SD 카드 | 약 ¥50 |
| 전원 | 공식 USB-C 어댑터 | 약 ¥50 |
| 쿨링 | 공식 쿨링 케이스 | 약 ¥80 |
| 합계 | 약 ¥680 |
라즈베리 파이의 월 전기료는 약 ¥7(소비 전력 ~3-5W) 정도로, 연간 운영 비용이 매우 저렴합니다.
라즈베리 파이의 한계
- 로컬 모델 추론 미지원: 메모리와 연산 능력이 부족하여 클라우드 API 호출만 가능해요.
- Node.js 성능: ARM 아키텍처 특성상 성능이 x86의 약 60~70% 수준입니다.
- SD 카드 안정성: 장기간 읽기/쓰기 시 SD 카드가 손상될 수 있으므로 내구성이 높은 카드를 사용하는 것이 좋아요.
라즈베리 파이는 '경량 오케스트레이션 센터' 역할을 수행하기에 적합해요. 메시지 연결과 작업 스케줄링을 담당하고, 실제 AI 추론 작업은 클라우드 API를 통해 처리하는 방식이죠.
4가지 OpenClaw 배포 옵션 비교 분석
| 구분 | Mac Mini | VPS 클라우드 서버 | 라즈베리 파이 | 1Panel/바오타(宝塔) |
|---|---|---|---|---|
| 초기 비용 | ¥4,000-8,000 | ¥0 | ¥680 | ¥0 |
| 월 유지비 | API + 전기료 ¥10 | ¥25-150 + API | API + 전기료 ¥7 | VPS 비용 + API |
| 24/7 안정성 | 가정 환경에 의존 | 데이터 센터급 | 가정 환경에 의존 | 데이터 센터급 |
| 데이터 프라이버시 | 100% 로컬 | 서버 측 저장 | 100% 로컬 | 서버 측 저장 |
| iMessage | 지원 | 미지원 | 미지원 | 미지원 |
| 로컬 모델 | 지원 (16GB 이상) | VPS 사양에 따름 | 미지원 | VPS 사양에 따름 |
| 기술적 난이도 | 터미널 기초 | SSH + 운영 관리 | 터미널 + 하드웨어 | 패널 조작 |
| 원격 접속 | Tailscale 필요 | 기본 지원 | Tailscale 필요 | 기본 지원 |
| 확장성 | 단일 기기 | 언제든 사양 변경 가능 | 단일 기기 | 언제든 사양 변경 가능 |
| 추천 대상 | 프라이버시 중시 사용자 | DevOps 사용자 | 가성비 중시 사용자 | 기존 서버 사용자 |
공식 권장 단계별 배포 경로
OpenClaw 공식 문서에서 제안하는 배포 단계는 다음과 같아요.
- 1개월 차: 로컬 컴퓨터에서 실행하며 시스템 익히기
- 2개월 차: 설정을 도커(Docker)화하기
- 3개월 차: VPS에 배포하여 상시 가동 환경 구축하기
하이브리드 배포 모드
OpenClaw는 하이브리드 아키텍처를 지원합니다. 게이트웨이(Gateway)는 클라우드 VPS에 배포해 24시간 온라인 상태를 유지하고, 동시에 로컬 Mac/iOS/Android 기기를 '노드(Node)'로 연결해 화면 제어, 카메라, 캔버스 등 하드웨어 기능을 활용하는 방식이에요.
이 모드를 사용하면 클라우드의 안정성과 로컬 기기의 하드웨어 성능을 모두 누릴 수 있습니다.
OpenClaw 배포 자주 묻는 질문 FAQ
Q1: 로컬 배포 시 컴퓨터가 절전 모드가 되면 OpenClaw가 계속 작동하나요?
아니요, 작동하지 않습니다. 컴퓨터가 절전 모드에 들어가면 모든 프로세스가 일시 중지되어 Gateway와 메시지 플랫폼 간의 연결이 끊어집니다. 따라서 시스템 설정에서 절전 모드를 비활성화하여 컴퓨터가 항상 깨어 있는 상태를 유지해야 합니다. Mac Mini의 경우 대기 전력이 5~10W 정도로 매우 낮아, 장기간 실행해도 전기세 부담이 적습니다.
Q2: 1Panel 설치 후 openclaw.json 파일을 어떻게 수정하나요?
1Panel의 Docker 관리 인터페이스로 이동하여 OpenClaw 컨테이너를 찾으세요. 컨테이너 터미널에 접속하거나 파일 관리자를 통해 ~/.openclaw/openclaw.json 경로에 접근하면 됩니다. 파일을 수정한 후에는 Gateway가 자동으로 핫 리로드(Hot Reload)를 수행하므로 수동으로 재시작할 필요가 없습니다. 또는 호스트 컴퓨터에서 Docker 볼륨 매핑을 통해 직접 편집할 수도 있습니다.
Q3: OpenClaw의 API 호출 비용은 대략 얼마인가요?
사용 빈도와 선택한 모델에 따라 다릅니다. 매일 20~50개의 메시지를 주고받는 일반적인 사용 환경에서의 예상 비용은 다음과 같습니다.
- Claude Sonnet 사용 시: 월 약 $15~30
- GPT-4o 사용 시: 월 약 $10~25
API 중계 서비스인 APIYI(apiyi.com) 플랫폼을 이용하면 유연한 충전 방식과 사용량 관리가 가능하여, 장기간 OpenClaw 에이전트를 운영하기에 매우 적합합니다.
Q4: VPS 배포와 1Panel 배포는 어떤 차이가 있나요?
본질적으로는 같은 서버를 사용하지만, 관리 방식에서 차이가 납니다.
- 순수 VPS: SSH 명령줄을 통해 관리하며 자유도가 높지만, 서버 운영 지식이 필요합니다.
- 1Panel/BT(바오타): 웹 관리 인터페이스를 제공하여 시각적으로 조작할 수 있어 초보자도 쉽게 접근할 수 있습니다.
이미 1Panel이나 바오타로 서버를 관리하고 있다면, 해당 패널에서 OpenClaw를 배포하는 것이 가장 간편합니다. APIYI(apiyi.com)에서 제공하는 API 인터페이스는 두 방식 모두 설정 방법이 동일합니다.
OpenClaw 배포 방안 요약
어떤 OpenClaw 배포 방안을 선택할지 고민된다면 다음 의사결정 트리를 참고해 보세요.
- iMessage 사용이 필수인가요? → Mac Mini (macOS 전용 기능)
- 철저한 개인정보 보호를 원하시나요? → Mac Mini 또는 라즈베리 파이 (데이터 100% 로컬 저장)
- 24시간 안정적인 접속이 중요한가요? → VPS 또는 1Panel/바오타 (데이터 센터급 안정성)
- 이미 서버와 관리 패널을 사용 중인가요? → 1Panel 원클릭 설치 (가장 낮은 진입 장벽)
- 예산이 매우 한정적인가요? → 라즈베리 파이 (약 13만 원대 일회성 비용 + 월 약 1,500원 전기세)
- 비용 없이 시작하고 싶나요? → Oracle Cloud 무료 VPS (4 CPU + 24GB RAM)
어떤 방안을 선택하든, **APIYI(apiyi.com)**를 통해 AI 모델 API를 통합 설정하는 것을 추천합니다. openclaw.json에서 APIYI의 baseUrl과 apiKey를 한 번만 설정하면 Claude, GPT 등 다양한 모델을 동시에 사용할 수 있어 관리가 간편하고 모델 전환도 자유롭습니다.
참고 자료
-
OpenClaw 공식 설치 문서: 공식 배포 가이드
- 링크:
docs.openclaw.ai/install - 설명: 모든 설치 방식에 대한 상세 단계를 포함하고 있습니다.
- 링크:
-
OpenClaw VPS 배포 문서: 클라우드 서버 전용 가이드
- 링크:
docs.openclaw.ai/vps - 설명: VPS 보안 설정 및 Docker 배포 방법을 다룹니다.
- 링크:
-
1Panel 공식 문서: 패널을 이용한 OpenClaw 설치
- 링크:
1panel.cn/docs - 설명: 1Panel 앱 스토어에서의 OpenClaw 설치 가이드입니다.
- 링크:
-
APIYI 공식 문서: OpenClaw 모델 설정 가이드
- 링크:
help.apiyi.com - 설명: openclaw.json 파일 내 APIYI 인터페이스 설정 튜토리얼입니다.
- 링크:
이 글은 OpenClaw의 실제 배포 경험을 바탕으로 APIYI 기술 팀에서 작성했습니다. 더 많은 기술 튜토리얼은 APIYI(apiyi.com)에서 확인하실 수 있습니다.
