VPS에 Clawdbot 설치하는 방법
VPS에 Clawdbot 설치하는 방법
Clawdbot은 오픈 소스 기반의 셀프 호스팅 개인 AI 비서로, 좋아하는 메시징 플랫폼과 연결됩니다. ChatGPT 같은 클라우드 기반 AI 비서와 달리 Clawdbot은 완전히 사용자의 인프라에서 실행되어 데이터와 개인정보를 완벽하게 제어할 수 있습니다. 이 글에서는 Node.js를 사용해 VPS에 Clawdbot을 설치하는 과정을 안내합니다. VPS 제공업체로는 LightNode를 추천합니다.
Clawdbot이란?
Clawdbot은 좋아하는 앱과 메시징 플랫폼 내에서 작동하는 강력한 개인 AI 비서입니다. WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Microsoft Teams, Google Chat 등 10개 이상의 플랫폼과 연결되어 대형 언어 모델을 진정한 개인 맞춤형, 항상 사용 가능한 동반자로 변모시킵니다. 주요 기능은 다음과 같습니다:
- 다중 플랫폼 지원: 10개 이상의 메시징 플랫폼에서 작동
- 지속적인 메모리: 사용자의 선호도와 과거 대화를 기억
- 능동적 행동: 작업 수행, 알림 설정, 알림 전송 가능
- 셀프 호스팅: 데이터 소유권과 개인정보 보호 완전 제어
- 맞춤형 확장성: 스킬과 도구로 확장 가능
- 항상 켜짐: VPS 또는 로컬 머신에서 24시간 365일 실행
사전 준비 사항
시작하기 전에 다음을 준비하세요:
- VPS 서버: 다양한 클라우드 서비스 제공업체 중 선택 가능하며, 성능과 글로벌 커버리지가 뛰어난 LightNode를 추천합니다.
- 기본 명령어 지식: 터미널 명령어에 익숙하면 도움이 됩니다.
- Node.js 설치: 서버에 Node.js 22 이상이 설치되어 있어야 합니다.
- 최소 시스템 요구사항: 2GB RAM, 1 vCPU, 10GB 디스크 공간 (프로덕션 용도는 4GB RAM 권장).
LightNode VPS를 추천하는 이유
LightNode는 Clawdbot 호스팅에 적합한 여러 이유가 있습니다:
LightNode의 주요 장점
- 합리적인 가격: 시간 단위 과금으로 월 $7.71부터 시작하며, 장기 약정 없이 테스트 가능
- 40개 이상의 글로벌 위치: 미국, 유럽, 아시아, 중동, 아프리카 등 6개 대륙에 데이터센터가 있어 전 세계 사용자에게 낮은 지연 시간 제공
- 고성능: NVMe SSD 저장소와 고주파수 CPU로 AI 워크로드에 최적화
- 99.95% 가동 시간 보장: 로컬 BGP 접속으로 안정적인 인프라 제공
- 유연한 과금: 사용한 만큼만 시간 단위로 결제 가능, 테스트 및 확장에 적합
- 개발자 친화적: 전체 루트 권한, 즉시 배포, Linux 및 Windows 지원
- 무료 스냅샷: VPS당 1회 무료 스냅샷 제공으로 백업 및 복구 용이
- 신규 사용자 보너스: 첫 충전 시 최대 $15 무료 크레딧 제공
Clawdbot용 추천 LightNode 구성
| 구성 요소 | 사양 | 월 비용 |
|---|---|---|
| 플랜 | Agency | $14.70/월 |
| CPU | 2 vCPU | - |
| RAM | 4GB DDR4 | - |
| 저장소 | 50GB NVMe SSD | - |
| 대역폭 | 2TB | - |
| 위치 | 싱가포르, 홍콩 또는 실리콘밸리 | - |
이 구성은 Clawdbot 운영에 충분한 자원을 제공하며, 사용량 증가에 따른 확장 여유도 있습니다.
1단계: VPS 설정하기
인스턴스 생성: LightNode에 로그인 후 새 VPS 인스턴스를 만듭니다. 주요 사용자와 가까운 위치를 선택해 최적의 지연 시간을 확보하세요. 아시아 사용자는 싱가포르 또는 홍콩, 북미 사용자는 실리콘밸리를 추천합니다.
운영체제 선택: Ubuntu 22.04 LTS(권장) 또는 Ubuntu 24.04를 선택하세요. 이 버전들은 Node.js 지원이 뛰어나고 널리 검증되었습니다.
SSH 접속: SSH 클라이언트를 사용해 서버에 접속합니다:
ssh username@your_server_ip
2단계: Node.js 설치
Clawdbot은 Node.js 22 이상이 필요합니다. Ubuntu에서 설치하는 방법은 다음과 같습니다:
# 패키지 목록 업데이트
sudo apt update
# NodeSource 저장소에서 Node.js 22 설치
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
# 설치 확인
node --version
# v22.x.x 출력되어야 함또는 NVM(Node Version Manager)을 사용해 더 유연하게 설치할 수 있습니다:
# NVM 설치
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
# Node.js 22 설치 및 사용
nvm install 22
nvm use 22
# 설치 확인
node --version3단계: Clawdbot 설치
여러 설치 방법이 있으니 필요에 맞게 선택하세요.
방법 1: 공식 설치 스크립트 (초보자 권장)
설치 스크립트는 가장 쉽고 의존성도 자동 처리합니다:
# 설치 스크립트 다운로드 및 실행
curl -fsSL https://clawd.bot/install.sh | bash이 명령은:
- 운영체제 감지
- Node.js 22+ 설치 여부 확인
- npm을 통해 Clawdbot 글로벌 설치
- 필요한 경로 설정
- 설치 검증을 위한 doctor 명령 실행
방법 2: npm 글로벌 설치
npm에 익숙한 사용자를 위한 방법:
# Clawdbot 글로벌 설치
npm install -g clawdbot@latest
# 또는 pnpm 사용 시 (더 빠름)
pnpm add -g clawdbot@latest
# 설치 확인
clawdbot --version방법 3: 소스에서 설치 (개발자용)
# 저장소 클론
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
# 의존성 설치
pnpm install
# UI 빌드
pnpm ui:build
# 프로젝트 빌드
pnpm build
# 온보딩 마법사 실행
./dist/entry.js onboard --install-daemon방법 4: Docker 설치 (선택 사항)
컨테이너 배포용:
# 저장소 클론
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
# Docker 설정 스크립트 실행
./docker-setup.sh4단계: 온보딩 마법사 실행
설치 후 Clawdbot을 구성하기 위해 온보딩 마법사를 실행하세요:
# 대화형 온보딩 마법사 시작
clawdbot onboard --install-daemon마법사는 다음을 안내합니다:
- 게이트웨이 구성: 로컬 또는 원격 게이트웨이 모드 선택 및 포트 설정(기본값: 18789)
- 인증 설정: AI 모델 제공자 구성
- Anthropic (Claude): API 키 또는 OAuth(권장)
- OpenAI (ChatGPT/Codex): API 키
- 기타 제공자: 커스텀 엔드포인트 및 API 키
- 채널 구성: 메시징 플랫폼 설정
- WhatsApp: QR 코드 로그인
- Telegram: @BotFather에서 봇 토큰 발급
- Discord: Discord 개발자 포털에서 봇 토큰 발급
- Slack: OAuth 또는 봇 토큰
- 서비스 설치: 게이트웨이를 백그라운드 서비스(systemd)로 설치
- 에이전트 아이덴티티: 비서의 성격 및 기본 동작 설정
5단계: 게이트웨이 시작
온보딩 완료 후 게이트웨이가 자동으로 시작됩니다. 상태 확인은 다음과 같이 합니다:
# 게이트웨이 상태 확인
clawdbot gateway status
# 로그 보기
clawdbot logs --follow
# 상태 점검
clawdbot health서비스가 실행되지 않을 경우 수동 시작
# 포그라운드에서 게이트웨이 실행
clawdbot gateway --port 18789 --verbose서비스 관리
# 서비스 시작
systemctl --user start clawdbot-gateway.service
# 서비스 중지
systemctl --user stop clawdbot-gateway.service
# 서비스 재시작
systemctl --user restart clawdbot-gateway.service
# 부팅 시 자동 시작 활성화
systemctl --user enable clawdbot-gateway.service
# 서비스 로그 보기
journalctl --user -u clawdbot-gateway -f6단계: 대시보드 접속
Clawdbot 제어 UI는 웹 브라우저에서 접속 가능합니다:
http://your_server_ip:18789/온보딩 시 인증을 설정했다면 게이트웨이 토큰을 입력해야 대시보드에 접근할 수 있습니다.
SSH 터널을 통한 원격 접속
보안을 위해 원격에서 접속할 때는 SSH 터널을 설정하세요:
# 로컬 머신에서 SSH 터널 설정
ssh -N -L 18789:127.0.0.1:18789 username@your_server_ip
# 이후 로컬에서 접속
http://localhost:18789/7단계: 첫 채널 연결하기
WhatsApp 연결 방법:
# QR 코드 생성 및 표시
clawdbot channels login
# WhatsApp에서 스캔:
# 설정 → 연결된 기기 → 기기 연결스캔 후 WhatsApp이 Clawdbot에 연결됩니다.
Telegram
- Telegram에서 @BotFather에게 메시지 보내 봇 생성
- 안내에 따라 새 봇 생성
- 발급받은 봇 토큰 복사
- Clawdbot에 봇 추가:
clawdbot channels add --channel telegram --token "your_bot_token_here"Discord
- Discord 개발자 포털 접속
- 새 애플리케이션 생성
- "Bot" 탭에서 봇 활성화
- 봇 토큰 복사
- 봇을 Discord 서버에 적절한 권한으로 초대
- Clawdbot에 추가:
clawdbot channels add --channel discord --token "your_discord_bot_token"8단계: DM 안전 설정 구성
기본적으로 Clawdbot은 DM에서 페어링 모드를 사용합니다. 즉, 모르는 발신자는 페어링 코드를 받고 승인 전까지 메시지가 처리되지 않습니다.
# 대기 중인 페어링 요청 목록 확인
clawdbot pairing list whatsapp
# 페어링 요청 승인
clawdbot pairing approve whatsapp <pairing_code>
# 승인된 페어링 목록 보기
clawdbot pairing list whatsapp --approved이 동작은 ~/.clawdbot/clawdbot.json 구성 파일에서 변경할 수 있습니다.
9단계: 설치 테스트
모든 것이 정상 작동하는지 테스트 메시지를 보내보세요:
# 테스트 메시지 전송
clawdbot message send --to +15555550123 --message "Hello from Clawdbot!"
# 또는 Telegram에서 테스트
clawdbot message send --to @your_telegram_username --message "Hello!"또는 연결된 WhatsApp/Telegram/Discord로 직접 메시지를 보내면 Clawdbot 비서가 응답할 것입니다.
10단계: Nginx 구성 (선택 사항)
프로덕션 환경에서는 Nginx 리버스 프록시를 설정해 보안 강화 및 SSL 인증서 관리를 권장합니다.
Nginx 설치
sudo apt install -y nginxNginx 설정
Nginx 설정 파일 편집:
sudo nano /etc/nginx/sites-available/clawdbot다음 내용을 추가하세요:
server {
listen 80;
server_name your-domain.com; # 도메인으로 변경
location / {
proxy_pass http://localhost:18789;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_cache_bypass $http_upgrade;
}
}설정 활성화
# 심볼릭 링크 생성
sudo ln -s /etc/nginx/sites-available/clawdbot /etc/nginx/sites-enabled/
# Nginx 설정 테스트
sudo nginx -t
# Nginx 재시작
sudo systemctl restart nginxCertbot으로 SSL 추가 (권장)
# Certbot 설치
sudo apt install -y certbot python3-certbot-nginx
# SSL 인증서 발급
sudo certbot --nginx -d your-domain.com
# Certbot이 자동으로 Nginx SSL 설정 구성이후 Clawdbot은 다음 주소에서 접속 가능합니다:
https://your-domain.com/자주 발생하는 문제 해결
게이트웨이가 시작되지 않을 때
# 구성 오류 점검
clawdbot doctor
# 상세 로그 확인
journalctl --user -u clawdbot-gateway -n 50메모리 부족 오류
2GB RAM VPS에서 업데이트 중 메모리 부족 오류가 발생할 수 있습니다. 스왑 파일을 추가하세요:
# 2GB 스왑 파일 생성
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
# 스왑 파일 영구 적용
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab포트가 이미 사용 중일 때
포트 18789가 이미 사용 중이라면:
# 해당 포트를 사용하는 프로세스 확인
sudo lsof -i :18789
# 또는 다른 포트 사용
clawdbot gateway --port 18889봇이 응답하지 않을 때
- 게이트웨이 상태 확인:
clawdbot gateway status - 채널 구성 확인: 토큰이 올바르고 채널이 활성화되었는지 점검
- 인증 확인: API 키가 유효한지 확인
- 로그 검토:
clawdbot logs --follow로 오류 메시지 확인
Clawdbot 업데이트
최신 버전으로 업데이트하려면:
# 설치 스크립트 재실행
curl -fsSL https://clawd.bot/install.sh | bash
# 또는 npm으로 업데이트
npm update -g clawdbot@latest
# 게이트웨이 재시작
clawdbot gateway restart
# 상태 점검
clawdbot health결론
VPS에 Clawdbot을 설치하는 과정은 간단하며, 여러 메시징 플랫폼에서 접근 가능한 강력한 셀프 호스팅 AI 비서를 제공합니다. LightNode의 합리적인 가격, 글로벌 커버리지, 고성능 인프라 덕분에 개인 AI 비서를 자신 있게 배포할 수 있습니다.
이 가이드를 따라 약 20~30분 내에 VPS에서 Clawdbot을 실행하여 개인정보를 존중하고 데이터 완전 제어가 가능한 항상 켜져 있는 AI 동반자를 갖게 될 것입니다.
추가 맞춤 설정과 고급 기능은 Clawdbot GitHub 페이지의 공식 문서와 커뮤니티 토론을 참고하세요.
추가 자료
- Clawdbot 공식 문서
- Clawdbot GitHub 저장소
- LightNode VPS - 추천 VPS 제공업체
- Clawdbot 커뮤니티 Discord
- 스킬 마켓플레이스 - 비서 기능 확장용 추가 스킬