# 🦞 Clawdbot 문서

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

---

## 📋 목차

### 🏠 시작하기

- [개요](https://overview/README.md)

- [빠른 시작](https://overview/quickstart.md)

### 🏗 아키텍처

- [아키텍처 개요](https://architecture/README.md)

- [시스템 아키텍처](https://architecture/system.md)

- [데이터 흐름](https://architecture/data-flow.md)

- [통신 프로토콜](https://architecture/protocol.md)

### 🔧 핵심 컴포넌트

- [Gateway](https://components/gateway.md)

- [Pi Agent Runtime](https://components/pi-agent.md)

- [세션 관리](https://components/sessions.md)

- [이벤트 시스템](https://components/events.md)

### 📨 채널 시스템

- [채널 개요](https://channels/README.md)

- [WhatsApp](https://channels/whatsapp.md)

- [Telegram](https://channels/telegram.md)

- [Slack](https://channels/slack.md)

- [Discord](https://channels/discord.md)

- [기타 채널](https://channels/others.md)

### 🛠 도구(Tools) 시스템

- [도구 개요](https://tools/README.md)

- [브라우저 제어](https://tools/browser.md)

- [Canvas/A2UI](https://tools/canvas.md)

- [디바이스 노드](https://tools/nodes.md)

- [Cron & 웹훅](https://tools/automation.md)

- [세션 도구](https://tools/sessions-tool.md)

### ⚙ CLI 및 설정

- [CLI 명령어](https://cli-config/commands.md)

- [설정 시스템](https://cli-config/configuration.md)

- [워크스페이스](https://cli-config/workspace.md)

- [스킬 시스템](https://cli-config/skills.md)

### 🔒 보안 및 샌드박싱

- [보안 개요](https://security/README.md)

- [DM 정책](https://security/dm-policy.md)

- [Docker 샌드박스](https://security/sandbox.md)

- [인증 및 권한](https://security/auth-permissions.md)

### 💻 개발 및 테스트

- [개발 환경](https://development/README.md)

- [테스트 가이드](https://development/testing.md)

- [코드 스타일](https://development/code-style.md)

- [기여 가이드](https://development/contributing.md)

### 🚀 설치 및 배포

- [설치 가이드](https://deployment/installation.md)

- [백그라운드 서비스](https://deployment/background-service.md)

- [Docker 배포](https://deployment/docker.md)

- [원격 접속](https://deployment/remote-access.md)

- [운영 가이드](https://deployment/operations.md)

### 📚 코드 예시

- [CLI 사용 예시](https://examples/cli.md)

- [WebSocket 프로토콜](https://examples/websocket.md)

- [설정 예시](https://examples/configuration.md)

- [스킬 개발](https://examples/skill-development.md)

- [채널 어댑터](https://examples/channel-adapter.md)

### 🎯 사용 가이드

- [시나리오 가이드](https://usage/scenarios.md)

- [문제 해결](https://usage/troubleshooting.md)

- [팁과 트릭](https://usage/tips-tricks.md)

- [고급 기능](https://usage/advanced-features.md)

### ⚡ 성능 최적화

- [성능 튜닝](https://performance/tuning.md)

- [메모리 관리](https://performance/memory.md)

- [리소스 최적화](https://performance/resources.md)

- [확장성](https://performance/scalability.md)

### 📊 비교 분석

- [프레임워크 비교](https://comparison/frameworks.md)

- [장단점](https://comparison/pros-cons.md)

- [선택 가이드](https://comparison/selection.md)

### 📈 다이어그램

- [아키텍처 다이어그램](https://diagrams/architecture.md)

- [데이터 흐름](https://diagrams/data-flow.md)

- [배포 아키텍처](https://diagrams/deployment.md)

- [시스템 ERD](https://diagrams/erd.md)

---

## 🔍 빠른 검색

### 주제별 문서 찾기

| 주제 | 문서 | 설명 |
| --- | --- | --- |
| **설치 방법** | [설치 가이드](https://deployment/installation.md) | NPM, Docker, 백그라운드 서비스 설치 |
| **아키텍처 이해** | [아키텍처 개요](https://architecture/README.md) | 전체 시스템 구조 이해 |
| **채널 설정** | [채널 개요](https://channels/README.md) | 각 메신저별 설정 방법 |
| **도구 사용** | [도구 개요](https://tools/README.md) | 브라우저, Canvas, 노드 사용법 |
| **보안 설정** | [보안 개요](https://security/README.md) | DM 정책, 샌드박스, 인증 설정 |
| **개발 시작** | [개발 환경](https://development/README.md) | 로컬 개발 환경 구성 |
| **문제 해결** | [문제 해결](https://usage/troubleshooting.md) | 일반적인 문제 해결 방법 |

### 사용자 레벨별 추천 문서

| 레벨 | 추천 문서 | 설명 |
| --- | --- | --- |
| **입문자** | [빠른 시작](https://overview/quickstart.md), [설치 가이드](https://deployment/installation.md) | 기본 설치부터 첫 사용까지 |
| **중급 사용자** | [사용 시나리오 가이드](https://usage/scenarios.md), [고급 기능](https://usage/advanced-features.md) | 실제 사용 시나리오와 고급 기능 |
| **개발자** | [개발 환경](https://development/README.md), [코드 예시](https://examples/cli.md) | 소스 코드 수정, 기능 확장 |
| **운영자** | [운영 가이드](https://deployment/operations.md), [성능 튜닝](https://performance/tuning.md) | 프로덕션 배포 및 운영 |
| **보안 전문가** | [보안 개요](https://security/README.md), [Docker 샌드박스](https://security/sandbox.md) | 보안 모델 심층 이해 |

---

## 🌐 외부 자료

### 공식 문서

- 📖 [메인 문서](https://docs.clawd.bot)

- 🏗 [아키텍처](https://docs.clawd.bot/concepts/architecture)

- 🚪 [채널 가이드](https://docs.clawd.bot/channels)

- 🔧 [설정 레퍼런스](https://docs.clawd.bot/gateway/configuration)

### 커뮤니티

- 💬 [Discord 서버](https://discord.gg/clawd)

- 🐙 [GitHub 리포지토리](https://github.com/clawdbot/clawdbot)

- 🌐 [웹사이트](https://clawdbot.com)

- 📦 [npm 패키지](https://www.npmjs.com/package/clawdbot)

---

## 📝 문서 업데이트

- **버전**: v2026.1.25

- **마지막 업데이트**: 2026년 1월 26일

- **라이선스**: MIT

이 문서는 Clawdbot v2026.1.25 버전을 기준으로 작성되었습니다. 버전에 따라 일부 기능이 다를 수 있습니다.

---

## 📋 빠른 시작 가이드

### 1. 설치

```javascript
# 글로벌 설치 (권장)
npm install -g clawdbot@latest

# 설치 확인
clawdbot --version
```

### 2. 온보딩

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

### 3. 채널 로그인

```javascript
# WhatsApp 로그인
clawdbot channels login whatsapp

# Telegram 로그인
clawdbot channels login telegram
```

### 4. 첫 사용

```javascript
# 메시지 전송
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

- 채널 어댑터 인터페이스

For the site tree, see the [root Markdown](https://slashpage.com/techkwon.md).