Clawdbot: 당신의 개인 AI 비서 플랫폼 🦞

개요

Clawdbot은 사용자가 인공 지능과 상호 작용하는 방식을 혁신하는 혁신적인 오픈 소스 개인 AI 비서 플랫폼입니다. 기존의 클라우드 기반 비서와 달리 Clawdbot은 로컬 하드웨어에서 완전히 실행되면서도 매일 사용하는 메시징 애플리케이션과 원활하게 통합됩니다.

Peter Steinberger가 만들고 활발한 커뮤니티에서 유지 관리하는 Clawdbot은 강력한 언어 모델(Claude, GPT, Gemini)과 일상적인 커뮤니케이션 채널 간의 다리 역할을 하여 개인 정보 보호를 존중하고 전례 없는 제어를 제공하는 진정으로 개인화된 AI 경험을 만듭니다.

🚀 핵심 기능

멀티 플랫폼 통합

• 메시징 플랫폼: WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Microsoft Teams, Google Chat
• 확장 채널: BlueBubbles, Matrix, Zalo, WebChat
• 모바일 지원: iOS 및 Android 컴패니언 앱
• 데스크톱: 음성 호출 기능이 있는 macOS 메뉴 바 앱

로컬 우선 아키텍처

• 게이트웨이 시스템: 모든 연결 및 작업을 관리하는 단일 제어 평면
• 셀프 호스팅: 모든 하드웨어(Mac, PC, Raspberry Pi 또는 클라우드 서버)에서 실행
• 개인 정보 보호 중심: 데이터는 절대 사용자의 제어를 벗어나지 않습니다.
• 영구 메모리: Markdown 파일로 로컬에 저장되는 장기 컨텍스트 유지

고급 기능

• 음성 통합: ElevenLabs TTS를 통한 항상 켜져 있는 음성 인식
• 라이브 캔버스: A2UI를 통한 에이전트 기반 시각적 작업 공간
• 브라우저 제어: 자동화된 웹 탐색 및 양식 채우기
• 시스템 액세스: 파일 관리, 셸 명령, Git 작업
• 스마트 홈: Philips Hue와 같은 장치와의 통합
• 사전 예방적 작업: 예약된 작업, 하트비트 모니터링, 자동화된 워크플로

🏗️ 기술 아키텍처

게이트웨이 중심 설계

WhatsApp / Telegram / Discord / iMessage (+ 플러그인)
                    │
                    ▼
    ┌───────────────────────────────┐
    │         게이트웨이            │
    │      (제어 평면)              │
    │   ws://127.0.0.1:18789        │
    └──────────────┬────────────────┘
                   │
    ├─ AI 에이전트 (RPC)
    ├─ CLI (clawdbot 명령)
    ├─ WebChat UI
    ├─ macOS 앱
    └─ iOS / Android 노드

주요 구성 요소

1. 게이트웨이 프로세스

• 모든 메시징 연결을 관리하는 장기 실행 데몬
• 클라이언트 통신을 위한 WebSocket 제어 평면
• 세션 라우팅 및 격리
• 실시간 이벤트 처리

2. 에이전트 시스템

• 다중 에이전트 라우팅 기능
• 작업 공간 기반 작업 (~clawd 디렉토리)
• 시스템 액세스를 위한 도구 통합 계층
• 안전한 실행을 위한 샌드박싱 옵션

3. 스킬 프레임워크

• 모듈식 TypeScript/JavaScript 확장
• 커뮤니티 기반 스킬 마켓플레이스 (ClawdHub)
• AI 생성 스킬을 통한 자체 개선 기능
• 사용자 지정 통합을 위한 플러그인 아키텍처

4. 보안 모델

• 알 수 없는 연락처를 위한 DM 페어링 시스템
• 그룹 대화를 위한 Docker 샌드박싱
• 구성 가능한 권한 시스템
• 감사 추적 및 보안 진단

🛠️ 설치 및 설정

빠른 시작

# 전역 설치
npm install -g clawdbot@latest

# 온보딩 마법사 실행
clawdbot onboard --install-daemon

# 게이트웨이 시작
clawdbot gateway --port 18789

개발 설정

# 리포지토리 복제
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# 종속성 설치
pnpm install
pnpm ui:build
pnpm build

# 온보딩 실행
pnpm clawdbot onboard --install-daemon

시스템 요구 사항

• 런타임: Node.js ≥22
• 운영 체제: macOS, Linux, Windows (WSL2 경유)
• 메모리: 2GB+ RAM 권장
• 저장 공간: 최적의 성능을 위해 SSD 권장

🔧 구성

핵심 구성

구성 파일은 ~/.clawdbot/clawdbot.json에 저장되며 다음과 같은 포괄적인 옵션을 제공합니다.

• 에이전트 설정: 작업 공간 경로, 모델 기본 설정, 사고 수준
• 채널 구성: 플랫폼별 설정 및 액세스 제어
• 보안: 샌드박스 모드, 허용 목록, DM 정책
• 도구: 스킬 활성화 및 권한 관리

다중 에이전트 설정

# 격리된 에이전트 인스턴스 생성
CLAWDBOT_CONFIG_PATH=~/.clawdbot/agent-a.json \
CLAWDBOT_STATE_DIR=~/.clawdbot-agent-a \
clawdbot gateway --port 19001

🎯 사용 사례 및 애플리케이션

개인 생산성

• 이메일 관리 및 자동 응답
• 일정 조정 및 회의 예약
• 여러 플랫폼에서 작업 자동화
• 문서 처리 및 파일 정리

개발 워크플로

• 코드 검토 및 풀 리퀘스트 관리
• CI/CD 파이프라인 모니터링
• 리포지토리 유지 관리
• 자동화된 테스트 및 배포

스마트 홈 통합

• 장치 제어 및 자동화
• 환경 모니터링
• 예약된 루틴
• 음성 활성화 명령

창의적인 프로젝트

• 멀티미디어 지원 콘텐츠 생성
• 이미지 및 오디오 처리
• 소셜 미디어 관리
• 창의적인 글쓰기 지원

🌟 커뮤니티 및 생태계

활발한 개발

• GitHub 리포지토리: 18,000개 이상의 별과 함께 성장 중
• 릴리스 주기: 새로운 기능으로 빈번한 업데이트
• 커뮤니티 Discord: 수천 명의 활성 사용자
• 문서: 포괄적인 가이드 및 튜토리얼

플러그인 생태계

• ClawdHub: 중앙 집중식 스킬 리포지토리
• 커뮤니티 기여: 사용자 생성 스킬 및 플러그인
• 통합 라이브러리: 인기 서비스에 대한 사전 구축된 커넥터
• 개발자 도구: 확장 개발을 위한 SDK 및 CLI 유틸리티

📊 성능 및 확장성

토큰 효율성

• API 비용 절감을 위한 지능형 캐싱
• 대규모 대화를 위한 적응형 청킹
• 점진적 대체 메커니즘
• 컨텍스트 최적화 전략

리소스 관리

• 경량 게이트웨이 프로세스
• 효율적인 WebSocket 통신
• 장기 실행 세션을 위한 최적화된 메모리 사용량
• 구성 가능한 리소스 제한

🔒 보안 및 개인 정보 보호

개인 정보 보호 우선 설계

• 모든 데이터 처리는 로컬에서 수행됩니다.
• 핵심 기능에 대한 클라우드 종속성 없음
• 사용자 제어 데이터 보존 정책
• 투명한 로깅 및 감사 기능

보안 기능

• 샌드박스 실행 환경
• 권한 기반 도구 액세스
• 안전한 자격 증명 관리
• 네트워크 격리 옵션

🚧 현재 제한 사항 및 고려 사항

기술적 과제

• 설정 복잡성: 초기 구성을 위해 기술 지식이 필요합니다.
• API 비용: 최적의 성능을 위해 유료 LLM 서비스에 의존합니다.
• 리소스 요구 사항: 항상 켜져 있는 설정은 전용 하드웨어에서 이점을 얻습니다.
• 초기 단계: 때때로 호환성이 깨지는 변경이 있는 활발한 개발

완화 전략

• 개선된 온보딩 마법사가 설정 복잡성을 줄입니다.
• 로컬 모델 지원으로 API 종속성을 줄입니다.
• 포괄적인 문서 및 커뮤니티 지원
• Docker 컨테이너는 격리 및 일관성을 제공합니다.

🔮 향후 로드맵

계획된 개선 사항

• 향상된 로컬 모델 지원: 오픈 소스 LLM과의 통합 개선
• 모바일 앱 확장: iOS 및 Android 전반의 기능 동등성
• 시각적 인터페이스 개선: 고급 캔버스 및 A2UI 기능
• 엔터프라이즈 기능: 팀 협업 및 관리 도구

커뮤니티 목표

• 더 넓은 플랫폼 지원: 추가 메시징 플랫폼 통합
• 간소화된 설정: 원클릭 설치 경험
• 성능 최적화: 리소스 소비 감소
• 교육 자료: 튜토리얼 및 인증 프로그램

🤝 참여 방법

사용자용

• 설치 가이드: 시작하기 문서
• 커뮤니티 Discord: 토론에 참여하고 지원 받기
• 스킬 마켓플레이스: ClawdHub를 통해 스킬 탐색 및 기여
• 피드백: GitHub에서 문제 보고 및 기능 제안

개발자용

• 기여: 개발 지침은 CONTRIBUTING.md 참조
• 플러그인 개발: 사용자 지정 스킬 및 통합 생성
• 문서: 가이드 및 튜토리얼 개선 지원
• 테스트: 베타 테스트 및 품질 보증 참여

📚 리소스 및 링크

• 공식 웹사이트: clawd.bot
• GitHub 리포지토리: github.com/clawdbot/clawdbot
• 문서: docs.clawd.bot
• 커뮤니티 Discord: 활발한 지원 및 개발 토론
• NPM 패키지: npmjs.com/package/clawdbot

---

Clawdbot은 개인 AI 비서의 미래를 대표합니다: 로컬에서 제어되고, 무한히 확장 가능하며, 일상 워크플로에 원활하게 통합됩니다. 혁명에 동참하여 AI 경험을 제어하세요! 🦞