OpenClaw 설치 및 배포 방법 - 완벽 가이드
OpenClaw 설치 및 배포 방법: 완벽 가이드
OpenClaw는 개인 AI 어시스턴트로, 사용자의 기기에서 직접 실행되며 로컬 우선(local-first) 방식의 AI 자동화를 제공합니다. 이 가이드에서는 LightNode를 포함한 다양한 플랫폼에서 OpenClaw를 배포하는 방법을 살펴봅니다.
OpenClaw란?
OpenClaw는 개인 AI 어시스턴트로, 모든 데이터를 사용자의 기기에 저장하면서 WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage, Microsoft Teams 등과 연결됩니다. 이 프로젝트는 GitHub에서 113,000개 이상의 스타를 보유하고 있습니다.
주요 기능:
- 다중 채널 인박스
- 로컬 우선 아키텍처
- 자율 운영
- 음성 웨이크 및 대화 모드
- 종합 도구 시스템
진화 과정: Clawdbot에서 OpenClaw까지
프로젝트는 여러 차례 이름이 변경되었습니다:
Clawd (2025년 11월): Peter Steinberger가 처음 출시한 이름.
Clawdbot: 첫 공식 리브랜딩.
Moltbot (2026년 1월 27-28일): Anthropic이 Clawd가 Claude와 유사하다는 이유로 상표권 요청을 하면서 이름 변경. 이 과정에서 암호화폐 사기꾼들이 소셜 미디어 계정을 탈취하고 최고 시가총액 1,600만 달러에 달하는 가짜 $CLAWD 토큰을 발행했습니다.
OpenClaw (2026년 1월 30일): 상표권 문제를 피하고 오픈소스 특성을 반영하기 위해 최종 리브랜딩.
OpenClaw가 기존 AI 에이전트와 다른 점
로컬 우선 vs 클라우드 전용: OpenClaw는 사용자의 하드웨어에서 실행되며 데이터가 기기를 벗어나지 않습니다.
능동적 자율성: OpenClaw는 백그라운드에서 지속적으로 실행되며 독립적으로 작업을 시작할 수 있습니다.
다중 플랫폼 통합: WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage, Microsoft Teams 등과 연결됩니다.
작업 수행 가능: 셸 명령 실행, 파일 관리, 브라우저 제어, 알림 전송 등이 가능합니다.
논란 및 도전 과제
보안 문제: 수백 개의 잘못 구성된 OpenClaw 인스턴스가 공개되어 API 키와 봇 자격 증명이 노출되었습니다. 보안 전문가들은 “당신의 어시스턴트, 당신의 기기, 당신의 책임”이라고 강조합니다.
암호화폐 사기 사건: Moltbot 전환 기간 중 프로젝트 계정이 잠시 탈취되어 암호화폐 사기가 발생했습니다.
과대광고 비판: 일부 커뮤니티 구성원들은 이 프로젝트가 기존 LLM 기술을 기반으로 하여 과대평가되었다고 주장합니다.
시스템 요구 사항
최소:
- 운영체제: macOS 10.15 이상, Linux Ubuntu 20.04 이상, Windows 11 WSL2 포함
- RAM: 최소 8GB (권장 16GB)
- 저장 공간: 최소 20GB
- Docker: 최신 안정 버전
- Node.js: 버전 22 이상 (네이티브 설치용)
권장:
- RAM: 16GB 이상
- 저장 공간: 50GB 이상 SSD
설치 방법
방법 1: Docker 설치
Docker 설치:
sudo apt-get update
sudo apt-get install -y docker.io docker-compose
sudo systemctl start dockerOpenClaw 배포:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
chmod +x docker-setup.sh
./docker-setup.sh
cp .env.example .env
nano .env # API 키 입력
docker-compose up -d
docker-compose logs -f openclaw-gateway방법 2: 네이티브 설치
Node.js 및 pnpm 설치:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22
nvm use 22
npm install -g pnpm빌드 및 실행:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
pnpm openclaw onboard --install-daemon
pnpm openclaw gateway --port 18789 --verbose방법 3: VPS 원클릭 배포
추천 플랫폼: LightNode, Hostinger, Zeabur, Railway, Render.
LightNode VPS에 배포하기
LightNode는 다음을 제공합니다:
- 40개 이상의 글로벌 데이터 센터 위치
- 시간 단위 과금
- NVMe SSD 스토리지
- 월 $5-15부터 시작
단계:
LightNode에서 계정 생성
VPS 인스턴스 생성:
- CPU: 최소 2 vCPU (권장 4 vCPU)
- RAM: 최소 4GB (권장 8GB)
- 저장 공간: 50GB NVMe SSD
- 운영체제: Ubuntu 22.04 LTS
- 위치: 사용자와 가장 가까운 곳 선택
SSH 연결:
ssh root@your_server_ip설치 및 배포:
apt-get update && apt-get install -y docker.io docker-compose git clone https://github.com/openclaw/openclaw.git cd openclaw cp .env.example .env nano .env docker-compose up -d확인:
docker-compose logs -f openclaw-gateway
설치 후 구성
온보딩 마법사: pnpm openclaw onboard --install-daemon 명령어로 안내 설정 실행.
메시징 채널:
- Telegram: BotFather를 통해 봇 생성
- Discord: 개발자 포털에서 애플리케이션 생성
- Slack: api.slack.com에서 애플리케이션 생성
보안 설정: 기본 페어링 모드는 새 연락처 승인 필요. openclaw doctor 명령어로 설정 점검.
문제 해결
게이트웨이 연결 문제: 포트 18789 확인, API 키 검증, docker-compose logs로 로그 확인.
채널 인증 실패: 봇 토큰 및 권한 확인.
메모리 문제: RAM 할당량 증가, 활성 채널 수 줄이기.
업데이트 문제: 먼저 설정 백업, 안정/베타/개발 채널을 적절히 사용.
결론
OpenClaw는 다중 플랫폼 지원과 함께 강력한 로컬 우선 AI 어시스턴트 솔루션을 제공합니다. 설치에는 기술적 이해가 필요하지만, 로컬 우선 아키텍처는 뛰어난 개인정보 보호와 제어 권한을 보장합니다. LightNode는 안정적인 연속 운영을 위한 훌륭한 호스팅 옵션입니다.