모든 채팅 앱에서 사용할 수 있는 개인 AI 비서가 있다면 어떨까요? 내가 했던 말을 기억하고, 먼저 메시지를 보내 알림까지 해준다면요? Clawdbot이 바로 그런 혁신적인 오픈 소스 프로젝트입니다. Claude AI를 진정한 당신만의 전용 비서로 만들어 줍니다.
핵심 가치: 이 글을 다 읽고 나면 Clawdbot의 핵심 개념, 설치 및 설정 방법, 그리고 API 연결을 통해 Discord, Telegram, WhatsApp 등 8개 이상의 플랫폼에서 Clawdbot을 활용하는 방법을 완벽히 마스터하게 될 거예요.
Clawdbot이란 무엇일까요? 한 줄 요약
Clawdbot은 Peter Steinberger(PSPDFKit 창립자)가 개발한 오픈 소스 개인 AI 비서 프로젝트입니다. 기존의 웹 버전 ChatGPT나 Claude와 달리, Clawdbot은 여러분이 평소 사용하는 채팅 앱에서 직접 실행됩니다. WhatsApp에서 메시지를 보내면 WhatsApp으로 답장이 오고, Discord에서 질문하면 Discord에서 답변을 해주는 식이죠.
| 특징 | Clawdbot | 기존 AI 채팅 |
|---|---|---|
| 사용 방식 | 평소 사용하는 채팅 앱 내에서 사용 | 전용 웹사이트 접속 필요 |
| 대화 기억 | 플랫폼 간 지속적인 기억 유지 | 대화마다 독립적임 |
| 능동적 푸시 | 예약 알림 및 능동적 통지 지원 | 수동적인 응답만 가능 |
| 데이터 저장 | 로컬 Markdown 파일 | 클라우드에 저장 |
| 커스터마이징 능력 | 완전 프로그래밍 가능한 Skills 시스템 | 제한적인 커스텀 옵션 |
🎯 핵심 이해: Clawdbot은 AI 모델 자체가 아니라 'AI 게이트웨이'입니다. 여러분의 채팅 앱과 대규모 언어 모델 API를 연결하여, AI 능력을 일상적인 소통 도구에 자연스럽게 녹여내는 역할을 하죠.
Clawdbot 핵심 아키텍처: 3계층 디자인
Clawdbot의 아키텍처를 이해하면 나중에 설정을 변경하거나 문제를 해결할 때 큰 도움이 됩니다. Clawdbot은 다음과 같이 명확한 3계층 디자인을 채택하고 있어요.
1단계: Gateway 게이트웨이
Gateway는 Clawdbot의 핵심 컨트롤 플레인으로, 기본적으로 localhost:18789를 감시합니다.
- 모든 메시지 세션 관리
- 다양한 채널의 메시지 라우팅
- 도구 호출 및 Skills 실행 처리
- 대화 기록 및 메모리 시스템 유지
2단계: Channels 채널
Channels는 다양한 채팅 플랫폼과 연결하는 역할을 담당합니다.
| 채널 유형 | 지원 플랫폼 | 연결 방식 |
|---|---|---|
| 메신저(IM) | WhatsApp, Telegram, Signal | Bot API / 웹 프로토콜 |
| 협업 플랫폼 | Discord, Slack, Teams | Bot API |
| 애플 에코시스템 | iMessage, macOS | imsg CLI / 네이티브 통합 |
| 개방형 프로토콜 | Matrix, WebChat | 표준 프로토콜 연동 |
| 지역별 앱 | Zalo, BlueBubbles | 커뮤니티 플러그인 |
3단계: LLM 대규모 언어 모델
Clawdbot은 다양한 AI 모델 백엔드를 지원합니다.
| 모델 제공사 | 인증 방식 | 활용 사례 |
|---|---|---|
| Anthropic Claude | API Key / OAuth | 추천하는 첫 번째 선택, Clawdbot 기본 최적화 |
| OpenAI GPT | API Key / OAuth | 일반적인 활용 사례 |
| 제3자 API 프록시 | API Key | 비용 최적화 및 접근 편의성 |
🎯 기술 제안: Claude 모델을 호출할 때는 APIYI (apiyi.com) 플랫폼을 통해 API Key를 발급받는 것을 권장합니다. 이 플랫폼은 Claude 4 전체 모델 시리즈를 지원하며, OpenAI 호환 인터페이스를 제공합니다. 가격이 저렴하고 해외 결제 수단 없이도 편리하게 이용할 수 있다는 장점이 있습니다.
Clawdbot의 4가지 핵심 장점 상세 분석
장점 1: 모든 채널에서의 원활한 접속
Clawdbot의 '옴니채널(Omni-channel)' 개념은 다음을 의미해요:
- 하나의 어시스턴트, 다양한 채널: 스마트폰에서 WhatsApp으로 질문하고, 컴퓨터에서 Discord를 통해 대화를 이어갈 수 있어요.
- 문맥 자동 동기화: 어떤 채널을 통해 대화하든, 어시스턴트가 이전 대화 내용을 모두 기억하고 있어요.
- 메시지 지능형 라우팅: 특정 유형의 메시지가 특정 채널로 전달되도록 설정할 수 있어요.
장점 2: 지속적인 기억 시스템
기존 AI 채팅은 매번 대화할 때마다 이전 내용을 잊어버리는 '기억 상실' 상태가 되곤 하지만, Clawdbot은 달라요:
- 기억을 Obsidian 노트와 유사한 Markdown 파일로 저장해요.
- **시맨틱 검색(Semantic Search)**을 지원하여, 이전에 언급했던 정보들을 서로 연결할 수 있어요.
- 데이터가 클라우드에 업로드되지 않는 완전한 로컬 저장 방식을 사용해요.
~/clawd/
├── memories/ # 对话记忆
│ ├── 2026-01-26.md # 按日期组织
│ └── topics/ # 按主题分类
├── skills/ # 自定义技能
└── config.yaml # 配置文件
장점 3: 능동적인 푸시 알림 기능
이것은 Clawdbot이 다른 AI 어시스턴트와 차별화되는 킬러 기능이에요:
| 능동적 푸시 시나리오 | 예시 |
|---|---|
| 모닝 브리핑 | 매일 아침 8시 일정과 날씨 푸시 |
| 작업 리마인더 | 사용자가 언급했던 마감일 전에 미리 알림 |
| 모니터링 알람 | 모니터링 중인 웹사이트에 이상이 생기면 즉시 알림 |
| 정기 실행 | 정기적으로 스크립트를 실행하고 결과 보고 |
장점 4: Skills 스킬 시스템
Skills는 Clawdbot의 '플러그인' 시스템으로, Markdown이나 TypeScript 파일을 통해 정의할 수 있어요:
# skill: web-search
使用 Brave Search API 搜索网络内容
## 触发条件
当用户询问需要实时信息的问题时
실행 단계
- Brave Search API 호출
- 검색 결과 파싱
- 요약 답변 생성
커뮤니티에서 이미 100개 이상의 바로 사용 가능한 스킬(Skills)을 제공하고 있으며, 다음과 같은 기능을 포함합니다:
- 웹 브라우징 및 스크린샷
- 파일 읽기/쓰기 작업
- 일정 관리 통합
- 코드 실행 환경
- 스마트 홈 제어
---
## Clawdbot 설치 및 설정: 3단계 쾌속 가이드
### 환경 요구 사양
| 항목 | 요구 사항 |
|------|------|
| **Node.js** | ≥ 22.x |
| **운영 체제** | macOS / Linux / Windows (WSL2) |
| **메모리** | ≥ 2GB 사용 가능 여유 공간 |
| **AI API** | Claude 또는 OpenAI API 키 |
### 1단계: 글로벌 설치
```bash
# npm으로 설치 (권장)
npm install -g clawdbot@latest
# 또는 pnpm 사용
pnpm add -g clawdbot@latest
2단계: 설정 마법사 실행
# 대화형 설정 마법사 시작
clawdbot onboard --install-daemon
설정 마법사가 다음 과정을 차근차근 안내해 드립니다:
- AI 모델 설정 – Claude 또는 OpenAI API 키 입력
- 작업 디렉토리 설정 – 기본값은
~/clawd입니다. - 채널 활성화 – 연결하고자 하는 채팅 플랫폼을 선택합니다.
- 데몬(Daemon) 설치 – 게이트웨이(Gateway)가 백그라운드에서 계속 실행되도록 설정합니다.
🚀 빠른 시작: 아직 Claude API 키가 없으시다면, APIYI(apiyi.com) 플랫폼을 이용해 빠르게 발급받는 것을 추천드려요. 이 플랫폼은 바로 사용 가능한 API 인터페이스를 제공하며, 가입 즉시 무료 테스트 크레딧을 증정하여 5분 만에 모든 설정을 마칠 수 있습니다.
3단계: 설치 확인
# 서비스 상태 확인
clawdbot status
# 상세 상태(Health) 체크
clawdbot health
# 설정 문제 진단
clawdbot doctor
정상적으로 설정되었다면 다음과 같이 출력됩니다:
Gateway: ✓ Running on localhost:18789
Channels: ✓ Discord, Telegram connected
LLM: ✓ Claude API configured
Memory: ✓ 42 memories indexed
Clawdbot Discord 연동 설정 가이드
Discord는 Clawdbot에서 가장 자주 사용되는 채널 중 하나예요. 설정 단계는 다음과 같습니다.
1단계: Discord 봇 생성하기
- Discord Developer Portal에 접속합니다:
discord.com/developers/applications - 'New Application'을 클릭하여 애플리케이션을 생성합니다.
- 'Bot' 페이지로 이동하여 'Add Bot'을 클릭합니다.
- Bot Token을 기록해 둡니다 (Reset Token을 클릭하여 생성).
2단계: 봇 권한 설정하기
'OAuth2 → URL Generator'에서 다음 항목을 체크하세요.
| 권한 카테고리 | 세부 권한 |
|---|---|
| Scopes | bot, applications.commands |
| Bot Permissions | Send Messages, Read Message History, Embed Links |
3단계: 서버에 봇 초대하기
생성된 OAuth2 URL을 사용하여 여러분의 Discord 서버에 봇을 초대해 주세요.
4단계: Clawdbot 설정하기
# 대화형 방식으로 Discord 채널 설정
clawdbot configure --section channels.discord
Bot Token을 입력하면 Clawdbot이 자동으로 연결을 완료합니다.
5단계: 대화 테스트
Discord 서버에서 봇을 @태그하거나 개인 메시지(DM)를 보내보세요.
@ClawdBot 안녕, 자기소개 좀 해줄래?
봇이 Claude API를 사용해 답변을 생성하고 Discord로 전송해 줄 거예요.
Clawdbot API 설정 상세 안내
Clawdbot의 지능은 밑바탕이 되는 AI 대규모 언어 모델에서 나옵니다. 따라서 API를 올바르게 설정하는 것이 매우 중요해요.
공식 Anthropic API
# ~/clawd/config.yaml
llm:
provider: anthropic
model: claude-sonnet-4-20250514
apiKey: sk-ant-xxxxx
장점:
- 공식 서비스에 직접 연결되어 지연 시간이 가장 적습니다.
- 최신 모델을 지원합니다.
제한 사항:
- 해외 결제 가능한 신용카드가 필요합니다.
- 일부 지역에서는 접속이 제한될 수 있습니다.
서드파티 API 프록시 (권장)
# ~/clawd/config.yaml
llm:
provider: openai-compatible
model: claude-sonnet-4-20250514
apiKey: sk-xxxxx
baseUrl: https://api.apiyi.com/v1 # APIYI 통합 인터페이스 사용
💰 비용 최적화: 국내 사용자에게는 APIYI(apiyi.com)를 API 프록시로 사용하는 것이 더 좋은 선택일 수 있습니다. 이 플랫폼은 OpenAI 호환 포맷 인터페이스를 제공하며, Claude 전 시리즈 모델을 지원합니다. 가격도 공식 서비스보다 저렴하고 결제가 편리하다는 장점이 있어요.
OAuth 구독 인증
이미 Claude Pro/Max를 구독 중이라면:
clawdbot configure --section llm.oauth
장점은 기존 구독 할당량을 사용하여 추가 API 비용이 들지 않는다는 점입니다.
Clawdbot 주요 스킬(Skills) 설정
웹 검색 스킬
# Brave Search API 설정
clawdbot configure --section web
# Brave Search API 키를 입력하세요.
설정을 마치면 Clawdbot이 실시간 웹 정보를 검색하여 답변을 제공할 수 있어요.
파일 조작 스킬
Clawdbot에는 파일 읽기 및 쓰기 기능이 내장되어 있습니다.
나: ~/Documents/notes.md 파일 내용을 읽어줘
봇: 파일을 읽는 중입니다... [파일 내용]
나: 파일 끝에 "오늘의 할 일: 보고서 작성"이라는 내용을 추가해줘
봇: 파일에 내용이 추가되었습니다.
브라우저 스킬
나: example.com에 접속해서 스크린샷 찍어줘
봇: [브라우저 실행] → [페이지 로드] → [스크린샷 생성] → [이미지 반환]
커스텀 스킬
~/clawd/skills/ 디렉토리에 마크다운 파일을 생성하기만 하면 돼요.
# skill: daily-report
일일 업무 보고 생성기
## 설명
오늘의 대화 기록을 바탕으로 일일 업무 보고서를 생성합니다.
활성화 키워드
일일 보고서 생성, 오늘 요약
실행 로직
- 오늘의 모든 대화 기록 읽기
- 업무 관련 내용 추출
- 구조화된 일일 보고서 생성
## Clawdbot 비용 산정 및 비교
| 비용 항목 | 월 비용 | 설명 |
|----------|--------|------|
| **VPS 서버** | 약 ₩6,500 - 13,000 | 선택 사항, 로컬 실행 시 무료 |
| **Claude API** | 약 ₩13,000 - 26,000 | 사용량에 따라 다름 |
| **Claude Pro 구독** | 약 ₩26,000 | OAuth 인증 사용 시 API 비용 절감 가능 |
| **Claude Max 구독** | 약 ₩260,000 | 헤비 유저용, Opus 무제한 |
### 비용 최적화 제안
1. **로컬 실행**: 집에서 사용하는 컴퓨터나 Mac mini에서 실행하면 VPS 비용을 아낄 수 있어요.
2. **API 프록시**: APIYI(apiyi.com)를 통해 Claude API를 호출하면 훨씬 저렴한 가격으로 이용 가능합니다.
3. **모델 선택**: 일상적인 대화는 claude-haiku를 사용하고, 복잡한 작업이 필요할 때만 claude-sonnet으로 전환하세요.
4. **메모리 관리**: 불필요한 메모리는 정기적으로 정리해서 토큰 소모를 줄이는 것이 좋습니다.
---
## Clawdbot과 다른 솔루션 비교
| 비교 항목 | Clawdbot | ChatGPT 앱 | Claude 앱 | 자체 구축 봇 |
|----------|----------|-------------|------------|----------|
| **다중 플랫폼 지원** | ⭐⭐⭐⭐⭐ 8개 이상의 플랫폼 | ⭐⭐ 앱 전용 | ⭐⭐ 앱 전용 | ⭐⭐⭐ 개별 개발 필요 |
| **대화 메모리** | ⭐⭐⭐⭐⭐ 지속적인 로컬 저장 | ⭐⭐⭐ 클라우드 제한적 | ⭐⭐⭐ 클라우드 제한적 | ⭐⭐ 자체 구현 필요 |
| **능동적 푸시** | ⭐⭐⭐⭐⭐ 전체 지원 | ❌ 지원 안 함 | ❌ 지원 안 함 | ⭐⭐⭐ 자체 구현 필요 |
| **개인정보 보호** | ⭐⭐⭐⭐⭐ 로컬 저장 | ⭐⭐ 클라우드 저장 | ⭐⭐ 클라우드 저장 | ⭐⭐⭐⭐ 구현 방식에 따라 다름 |
| **커스터마이징 능력** | ⭐⭐⭐⭐⭐ Skills 시스템 | ⭐⭐ GPTs 제한적 | ⭐⭐ Projects | ⭐⭐⭐⭐⭐ 완전한 커스텀 |
| **시작 난이도** | ⭐⭐⭐ 기술적 기초 필요 | ⭐⭐⭐⭐⭐ 즉시 사용 가능 | ⭐⭐⭐⭐⭐ 즉시 사용 가능 | ⭐ 대량의 개발 필요 |
> 💡 **선택 제안**: Clawdbot은 어느 정도 기술적 배경이 있고 개인정보 보호와 심층적인 커스터마이징을 원하는 사용자에게 적합해요. 단순히 간단한 AI 대화만 필요하다면 공식 앱으로도 충분하지만, AI를 실제 일상 워크플로우에 진정으로 통합하고 싶다면 Clawdbot은 시간을 투자해 배울 가치가 충분합니다.
---
## 자주 묻는 질문 FAQ
<details open>
<summary><strong>Q1: Clawdbot을 사용하려면 VPS 서버가 꼭 필요한가요?</strong></summary>
꼭 그렇지는 않습니다. Clawdbot은 개인용 컴퓨터에서도 실행할 수 있으며, 컴퓨터가 켜져 있기만 하면 언제든 사용할 수 있어요. 하지만 24시간 내내 온라인 상태를 유지하고 싶다면 다음 방법을 추천드려요:
- 집에서 항상 켜두는 컴퓨터 (Mac mini 등)
- 클라우드 서버 (VPS, 월 7,000원~14,000원 내외)
- 개인용 NAS 장비
</details>
<details open>
<summary><strong>Q2: 해외 신용카드가 없는데 Claude API를 어떻게 발급받나요?</strong></summary>
APIYI(apiyi.com) 플랫폼을 통해 Claude API를 이용할 수 있습니다. 이 플랫폼은 알리페이, 위챗 결제를 지원하며, 공식 인터페이스와 동일한 API를 제공하면서도 가격은 더 저렴해요. 가입 후 API Key를 발급받아 Clawdbot에 설정하기만 하면 바로 사용할 수 있습니다.
</details>
<details open>
<summary><strong>Q3: Clawdbot은 한국어를 지원하나요?</strong></summary>
네, 완벽하게 지원합니다. Clawdbot 자체는 일종의 게이트웨이 역할을 할 뿐이며, 실제 AI 능력은 기저 모델(Claude/GPT)에서 나옵니다. 이러한 대규모 언어 모델들은 한국어를 아주 잘 지원하기 때문에, 한국어로 모든 대화를 진행하고 상호작용할 수 있습니다.
</details>
<details open>
<summary><strong>Q4: 대화 프라이버시는 어떻게 보장되나요?</strong></summary>
Clawdbot은 '로컬 우선(Local-first)' 설계 방식을 채택하고 있어요:
- 대화 기억은 사용자의 장치에 직접 저장됩니다 (Markdown 파일)
- 게이트웨이는 localhost에서 실행되며 공인 인터넷에 노출되지 않습니다
- SSH 터널이나 Tailscale을 통해 안전하게 원격 접속이 가능합니다
- 오직 AI 모델 호출을 위한 API 요청 시에만 네트워크 연결이 필요합니다
</details>
<details open>
<summary><strong>Q5: 문제가 발생하면 어디에 도움을 요청해야 하나요?</strong></summary>
Clawdbot은 활발한 커뮤니티를 운영하고 있습니다:
- **Discord 서버**: 참여 후 두 개의 Clawdbot 인스턴스와 직접 대화해 볼 수 있고, 질문도 가능합니다.
- **GitHub Issues**: `github.com/clawdbot/clawdbot`
- **공식 문서**: `docs.clawd.bot`
버그 제보에 대한 응답이 매우 빠른 편이며, 때로는 개발자가 채팅을 통해 실시간으로 문제를 해결해 주기도 합니다.
</details>
<details open>
<summary><strong>Q6: Windows 사용자는 어떻게 설치하나요?</strong></summary>
Windows 사용자는 WSL2 사용을 강력히 권장합니다:
1. WSL2 설치 (Ubuntu 배포판 추천)
2. WSL2 환경 내에 Node.js 22 이상 설치
3. Linux 설치 단계를 따라 Clawdbot 설치
기본 Windows 환경(Native) 지원은 아직 미흡하여 여러 가지 오류가 발생할 수 있습니다.
</details>
---
## Clawdbot 고급 활용 팁
### 1. 다중 에이전트 협업
Clawdbot은 여러 개의 세션(Session)을 생성할 수 있으며, 이 세션들은 서로 통신하며 협업할 수 있습니다:
Session A (研究助手): 调研市场数据
Session B (写作助手): 接收 A 的数据,生成报告
Session C (审核助手): 检查 B 的报告,提出修改建议
### 2. 자동화 워크플로우
Cron 예약 작업과 결합하여 다음과 같은 자동화를 구현해 보세요:
- 매일 오전 8시: 이메일함의 중요 메일 요약
- 매주 월요일 오전 9시: 지난주 업무 요약 생성
- 매월 1일: 이번 달 API 사용량 통계 확인
### 3. 스마트 홈 통합
Home Assistant나 MQTT를 통해 스마트 기기와 연결할 수 있습니다:
我: 把客厅灯调暗一点
Bot: [调用 Home Assistant API] 已将客厅灯亮度调至 50%
### 4. 코드 개발 보조
Clawdbot은 다음과 같은 개발 업무를 도울 수 있습니다:
- 코드 파일 읽기 및 설명
- shell 명령어 실행
- GitHub 저장소 탐색
- 코드 생성 및 파일 저장
---
## 요약 및 향후 계획
Clawdbot은 개인용 AI 어시스턴트의 새로운 패러다임을 제시합니다.
| 핵심 가치 | 설명 |
|----------|------|
| **언제 어디서나** | 자주 사용하는 채팅 소프트웨어에서 AI를 바로 사용하세요 |
| **잊지 않는 기억** | 지속적인 메모리 기능을 통해 당신을 진심으로 이해합니다 |
| **능동적인 서비스** | 수동적으로 기다리지 않고, 먼저 알림을 보내 서비스를 제공합니다 |
| **완벽한 제어** | 오픈 소스 기반의 자체 호스팅으로, 데이터는 영원히 사용자의 소유입니다 |
| **무한한 확장** | Skills 시스템을 통해 능력의 한계를 없앴습니다 |
**다음 단계**:
1. Clawdbot 설치하기: `npm install -g clawdbot@latest`
2. Claude API 키 발급: **APIYI**(apiyi.com)를 통해 쉽고 빠르게 발급받는 것을 추천합니다
3. 설정 마법사 실행: `clawdbot onboard --install-daemon`
4. 첫 번째 채널 연결하기 (Discord부터 시작해 보시는 걸 추천해요)
5. Clawdbot Discord 커뮤니티에 가입하여 다양한 경험 공유하기
---
## 참고 자료
1. **Clawdbot 공식 홈페이지**: 제품 소개 및 퀵 스타트 가이드
- 링크: `clawd.bot`
2. **Clawdbot 공식 문서**: 상세 설정 가이드
- 링크: `docs.clawd.bot`
3. **GitHub 저장소**: 오픈 소스 코드 및 이슈 확인
- 링크: `github.com/clawdbot/clawdbot`
4. **MacStories 심층 리뷰**: 실제 사용 경험 공유
- 링크: `macstories.net/stories/clawdbot-showed-me-what-the-future-of-personal-ai-assistants-looks-like/`
5. **Peter Steinberger 개인 사이트**: 제작자 블로그
- 링크: `steipete.me`
---
> 📝 **제작자**: APIYI Team
> 🔗 **기술 교류**: apiyi.com을 방문하여 더 많은 AI API 활용 팁을 확인해 보세요
> 📅 **업데이트 날짜**: 2026년 1월
