Sign In

🦞 Clawdbot 문서

버전: v2026.1.25
작성일: 2026년 1월 26일
라이선스: MIT

📋 목차

🏠 시작하기

🏗 아키텍처

🔧 핵심 컴포넌트

📨 채널 시스템

🛠 도구(Tools) 시스템

⚙ CLI 및 설정

🔒 보안 및 샌드박싱

💻 개발 및 테스트

🚀 설치 및 배포

📚 코드 예시

🎯 사용 가이드

⚡ 성능 최적화

📊 비교 분석

📈 다이어그램

🔍 빠른 검색

주제별 문서 찾기

주제
문서
설명
설치 방법
NPM, Docker, 백그라운드 서비스 설치
아키텍처 이해
전체 시스템 구조 이해
채널 설정
각 메신저별 설정 방법
도구 사용
브라우저, Canvas, 노드 사용법
보안 설정
DM 정책, 샌드박스, 인증 설정
개발 시작
로컬 개발 환경 구성
문제 해결
일반적인 문제 해결 방법

사용자 레벨별 추천 문서

레벨
추천 문서
설명
입문자
기본 설치부터 첫 사용까지
중급 사용자
실제 사용 시나리오와 고급 기능
개발자
소스 코드 수정, 기능 확장
운영자
프로덕션 배포 및 운영
보안 전문가
보안 모델 심층 이해

🌐 외부 자료

공식 문서

•
🏗 아키텍처

커뮤니티

•
🌐 웹사이트

📝 문서 업데이트

•
버전: v2026.1.25
•
마지막 업데이트: 2026년 1월 26일
•
라이선스: MIT
이 문서는 Clawdbot v2026.1.25 버전을 기준으로 작성되었습니다. 버전에 따라 일부 기능이 다를 수 있습니다.

📋 빠른 시작 가이드

1. 설치

# 글로벌 설치 (권장) npm install -g clawdbot@latest # 설치 확인 clawdbot --version

2. 온보딩

# 온보딩 위저드 실행 clawdbot onboard --install-daemon

3. 채널 로그인

# WhatsApp 로그인 clawdbot channels login whatsapp # Telegram 로그인 clawdbot channels login telegram

4. 첫 사용

# 메시지 전송 clawdbot send --to whatsapp:+1234567890 --message "안녕하세요!" # 상태 확인 clawdbot status

🎯 핵심 특징 요약

✅ 로컬 우선

•
모든 데이터가 사용자 장치에 저장됨
•
클라우드 API 호출을 제외하고 데이터 유출 없음
•
LLM 공급자와 직접 통신 (중간 서버 없음)

✅ 다중 채널 지원

•
13개 이상의 메신저 플랫폼 통합
•
WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage 등

✅ WebSocket 제어 평면

•
단일 Gateway가 모든 연결을 관리
•
기본 포트: ws://127.0.0.1:18789

✅ 다중 에이전트 라우팅

•
채널/계정/피어별로 세션 격리
•
다중 워크스페이스 지원
•
에이전트 간 통신 가능

✅ 브라우저 자동화

•
Playwright Core 기반 내장 브라우저
•
Canvas/A2UI를 통한 시각 작업공간

✅ 보안 모델

•
DM 페어링 (새로운 연결자 승인)
•
Docker 샌드박스 (비-main 세션 격리)
•
권한 관리 (도구별 허용/거부)

✅ 확장성

•
플러그인 시스템
•
스킬 개발 SDK
•
채널 어댑터 인터페이스
Made with Slashpage