AstrBot: 1,000+ 플러그인과 14개 메시징 플랫폼을 통합한 오픈소스 IM 챗봇

AstrBot

“동반성과 능력은 결코 상충되지 않아야 합니다. 우리가 만들고자 하는 것은 감정을 이해하고 진정한 동반자가 되며, 동시에 신뢰할 수 있게 작업을 완수하는 로봇입니다.”

이것이 AstrBot의 철학입니다. 22,174개의 GitHub 스타, 1,000개 이상의 커뮤니티 플러그인, 14개 메시징 플랫폼 지원—AstrBot은 단순한 챗봇 프레임워크가 아닙니다. IM 플랫폼과 LLM, AI 기능을 하나로 연결하는 오픈소스 IM 챗봇 인프라입니다.

탄생 배경: 2022년부터 쌓아온 성숙한 프로젝트

AstrBot은 2022년 12월부터 개발되었습니다. 3년이 넘는 기간 동안 꾸준히 발전해왔고, 현재 AstrBotDevs 팀이 관리하고 있습니다.

처음에는 QQ 봇으로 시작했지만, 점차 더 많은 플랫폼과 LLM을 지원하면서 범용 IM 챗봇 플랫폼으로 성장했습니다. Python으로 작성되어 확장성이 뛰어나고, 커뮤니티가 만든 1,000개 이상의 플러그인이 생태계를 풍요롭게 만들고 있습니다.

14개 메시징 플랫폼 통합

AstrBot Chatbot

AstrBot의 가장 큰 강점은 하나의 코드베이스로 14개 플랫폼을 모두 지원한다는 것입니다.

공식 지원 플랫폼

플랫폼	지원 형태
QQ	Go-CQHTTP, OneBot, QQ Bot
Telegram	Bot API
Discord	Bot Gateway
Slack	App & Bot
WeChat Work	企业微信
Feishu	飞书
DingTalk	钉钉
WeChat Official Accounts	微信公众号
LINE	Messaging API
Misskey	Fediverse
Satori	크로스 플랫폼 프로토콜
WhatsApp	Coming Soon

커뮤니티 플러그인으로 확장

Matrix — Fediverse 연동
KOOK — 게이밍 커뮤니티
VoceChat — 셀프 호스팅 채팅

하나의 봇 로직을 작성하면, 모든 플랫폼에서 동일하게 작동합니다. 플랫폼별로 코드를 따로 작성할 필요가 없습니다.

다중 LLM 지원: 상용부터 셀프 호스팅까지

AstrBot은 거의 모든 주요 LLM을 지원합니다.

상용 LLM

제공자	모델
OpenAI	GPT-4, GPT-3.5, o1, o3
Anthropic	Claude 3.5 Sonnet, Claude 3 Opus
Google	Gemini Pro, Gemini Flash
Moonshot AI	Kimi
Zhipu AI	GLM-4
DeepSeek	DeepSeek-V3, DeepSeek-Coder

셀프 호스팅

Ollama — 로컬 LLM 실행
LM Studio — GUI 기반 로컬 모델

중국 AI 서비스

AIHubMix — 멀티 모델 통합
302.AI — 중국 LLM 게이트웨이
SiliconFlow — 실리콘 플로우
PPIO Cloud — 클라우드 LLM

OpenAI 호환 API

OpenAI API 포맷을 사용하는 모든 서비스와 호환됩니다. vLLM, LocalAI, Text Generation WebUI 등도 바로 연결할 수 있습니다.

LLMOps 플랫폼 통합

AstrBot은 단순히 LLM만 연결하는 것이 아닙니다. Dify, Coze 같은 LLMOps 플랫폼과도 통합됩니다.

Dify 통합

Dify에서 만든 워크플로우, 에이전트, 지식 베이스를 그대로 AstrBot에서 사용할 수 있습니다. 시각적으로 워크플로우를 설계하고, AstrBot을 통해 IM 플랫폼에 연결합니다.

Alibaba Cloud Bailian

알리바바의 Bailian 플랫폼과 통합되어 엔터프라이즈급 AI 기능을 사용할 수 있습니다.

Coze

바이트댄스의 Coze 플랫폼과도 연동됩니다. Coze에서 만든 봇을 AstrBot으로 가져와 다양한 IM 채널에 배포할 수 있습니다.

AI 기능: 멀티모달부터 주도적 에이전트까지

멀티모달 지원

텍스트뿐 아니라 이미지, 오디오, 비디오를 이해하고 생성합니다. 이미지를 보내면 분석하고, 음성 메시지를 보내면 텍스트로 변환해서 처리합니다.

Agent & MCP

Agent 기능으로 복잡한 작업을 수행할 수 있습니다. MCP(Model Context Protocol)를 통해 외부 도구와 연동합니다.

Skills 시스템

AstrBot만의 Skills 시스템으로 에이전트의 능력을 확장합니다. 특정 작업에 특화된 스킬을 만들어 붙일 수 있습니다.

지식 베이스

RAG(Retrieval-Augmented Generation)를 지원합니다. 문서를 업로드하면 벡터 데이터베이스에 저장하고, 질문에 답할 때 관련 문서를 검색해서 정확한 답변을 제공합니다.

페르소나 설정

봇의 성격, 말투, 배경 스토리를 설정할 수 있습니다. 친절한 비서부터 장난기 많은 친구까지, 원하는 페르소나로 커스터마이즈할 수 있습니다.

자동 컨텍스트 압축

긴 대화도 자동으로 요약해서 컨텍스트 윈도우를 관리합니다. 대화가 길어져도 봇이 맥락을 잃지 않습니다.

롤플레이 & 감정적 동반자

AstrBot의 차별화된 기능입니다. 단순히 질문에 답하는 게 아니라, 감정적으로 교감하는 대화를 지원합니다.

“동반성과 능력은 결코 상충되지 않아야 합니다.”

이 슬로건이 말하듯, AstrBot은 감정을 이해하는 동반자이면서 동시에 실제 작업을 수행하는 능력을 갖춘 봇을 지향합니다.

주도적 에이전트 (Proactive Agent)

사용자가 질문할 때까지 기다리는 게 아니라, 상황에 따라 먼저 정보를 제공하거나 작업을 제안합니다. 스케줄 알림, 뉴스 요약, 모니터링 경고 등을 주도적으로 수행합니다.

1,000+ 커뮤니티 플러그인

AstrBot의 진짜 힘은 커뮤니티에 있습니다. 1,000개 이상의 플러그인이 이미 만들어져 있고, 원클릭으로 설치할 수 있습니다.

Agent Sandbox: 안전한 코드 실행

AstrBot은 격리된 샌드박스에서 코드를 실행합니다.

셸 호출 — 시스템 명령어 실행
세션 레벨 리소스 재사용 — 효율적인 리소스 관리
보안 격리 — 악성 코드로부터 시스템 보호

에이전트가 파일 시스템에 접근하거나 외부 명령을 실행할 때도 안전하게 처리됩니다.

WebUI & ChatUI

웹 기반 관리 인터페이스를 제공합니다.

관리자 UI

플러그인 설치/관리
LLM 설정
플랫폼 연동 구성
로그 모니터링
사용자 관리

ChatUI

웹에서 직접 봇과 대화
내장 에이전트 샌드박스
웹 검색 지원

별도의 클라이언트를 설치하지 않고도 브라우저에서 모든 것을 관리할 수 있습니다.

음성 기능: STT & TTS

STT (Speech-to-Text)

OpenAI Whisper — 고품질 다국어 인식
SenseVoice — 실시간 음성 인식

TTS (Text-to-Speech)

OpenAI TTS — 자연스러운 합성 음성
Gemini TTS — Google의 TTS
GPT-Sovits — 오픈소스 고품질 TTS
FishAudio — 실시간 음성 합성
Edge TTS — Microsoft Edge의 무료 TTS
Minimax TTS — 감정 표현이 가능한 TTS

음성 메시지를 받으면 텍스트로 변환해서 처리하고, 텍스트 응답을 음성으로 내보낼 수 있습니다.

배포 방법: 개발부터 프로덕션까지

1. uv 원클릭 배포 (권장)

가장 간단한 방법입니다.

uv tool install astrbot
astrbot init
astrbot

2. Docker / Docker Compose

컨테이너로 실행합니다.

docker run -d --name astrbot \
  -p 6185:6185 \
  -v ./data:/AstrBot/data \
  astrbot/astrbot:latest

3. RainYun 원클릭 클라우드 배포

RainYun 플랫폼에서 원클릭으로 배포할 수 있습니다.

4. AstrBot App

데스크톱 앱으로 실행합니다. Windows, macOS, Linux를 모두 지원합니다.

5. AstrBot Launcher

멀티 인스턴스 관리를 위한 데스크톱 런처입니다. 여러 봇을 동시에 실행할 수 있습니다.

6. Replit

온라인에서 바로 체험해볼 수 있습니다.

7. AUR (Arch Linux)

Arch Linux 사용자는 AUR에서 설치할 수 있습니다.

yay -S astrbot-git

8. 패널 기반 배포

BT Panel, 1Panel, CasaOS 같은 서버 관리 패널에서도 설치할 수 있습니다.

아키텍처 개요

AstrBot은 모듈형 아키텍처로 설계되었습니다.

┌─────────────────────────────────────┐
│           IM Platforms              │
│  QQ | Telegram | Discord | Slack    │
│  WeChat | Feishu | DingTalk | ...   │
└─────────────────┬───────────────────┘
                  │
┌─────────────────▼───────────────────┐
│         AstrBot Core                │
│  ┌─────────────────────────────┐    │
│  │     Platform Adapters       │    │
│  └─────────────────────────────┘    │
│  ┌─────────────────────────────┐    │
│  │     LLM Providers           │    │
│  └─────────────────────────────┘    │
│  ┌─────────────────────────────┐    │
│  │     Plugin System           │    │
│  └─────────────────────────────┘    │
│  ┌─────────────────────────────┐    │
│  │     Agent Sandbox           │    │
│  └─────────────────────────────┘    │
└─────────────────────────────────────┘

각 계층이 독립적으로 작동하면서도 유기적으로 연결됩니다. 플랫폼 어댑터만 교체하면 새로운 IM을 지원할 수 있고, LLM 프로바이더만 교체하면 다른 모델을 사용할 수 있습니다.

OpenClaw 대안으로서의 AstrBot

AstrBot은 “OpenClaw alternative”로 소개되기도 합니다. 실제로 두 프로젝트는 비슷한 목표를 가지고 있습니다:

특성	AstrBot	OpenClaw
주 언어	Python	TypeScript
IM 지원	14개 플랫폼	Discord, Telegram
LLM 지원	광범위	OpenAI, Anthropic, 로컬
플러그인	1,000+	스킬 시스템
LLMOps 통합	Dify, Coze, Bailian	MCP
WebUI	내장	Gateway

AstrBot은 특히 중국 시장에 강점이 있습니다. WeChat, Feishu, DingTalk 지원과 중국 AI 서비스 통합이 잘 되어 있습니다.

실제 사용 시나리오

시나리오 1: 멀티 플랫폼 고객 지원

요구사항: 회사가 WeChat, Feishu, DingTalk를 모두 사용 중이다. 하나의 봇으로 모든 플랫폼에서 고객 지원을 하고 싶다.

AstrBot 솔루션:

하나의 봇 로직 작성
세 플랫폼 모두에 연결
지식 베이스에 제품 매뉴얼 업로드
Dify에서 워크플로우 설계

시나리오 2: 개인 AI 비서

요구사항: Telegram과 Discord에서 사용할 개인 비서가 필요하다. 일정 관리, 리마인더, 웹 검색을 해야 한다.

AstrBot 솔루션:

OpenAI GPT-4 연결
주도적 에이전트 활성화
관련 플러그인 설치
페르소나를 “개인 비서”로 설정

시나리오 3: 롤플레이 챗봇

요구사항: 특정 캐릭터와 대화할 수 있는 챗봇을 만들고 싶다. 감정적으로 공감하고 긴 대화가 가능해야 한다.

AstrBot 솔루션:

Claude 3.5 Sonnet 연결 (자연스러운 대화)
페르소나에 캐릭터 설정
자동 컨텍스트 압축 활성화
롤플레이 모드 활성화

시나리오 4: 커뮤니티 관리 봇

요구사항: Discord 서버 관리 봇이 필요하다. 공지, 모더레이션, 게임 기능을 포함해야 한다.

AstrBot 솔루션:

Discord 플랫폼 연결
모더레이션 플러그인 설치
게임 플러그인 설치
공지 자동 발송 설정

커뮤니티와 생태계

활발한 개발

AstrBot은 꾸준히 업데이트되고 있습니다. GitHub에서 22,000+ 스타, 수백 개의 기여자가 활동 중입니다.

중국어 문서

공식 문서가 중국어로 잘 정리되어 있습니다. astrbot.app에서 확인할 수 있습니다.

플러그인 마켓플레이스

WebUI에서 바로 플러그인을 검색하고 설치할 수 있습니다. 별도의 파일 다운로드 없이 원클릭 설치가 가능합니다.

마치며: 감정과 능력의 공존

AstrBot은 흥미로운 질문을 던집니다. AI 챗봇이 감정적으로 교감하면서 동시에 실제 작업을 수행할 수 있을까?

AstrBot의 대답은 “그렇다”입니다. 롤플레이와 감정적 동반자 기능은 대화의 깊이를 더하고, Agent와 Skills 시스템은 실제 작업 수행 능력을 제공합니다.

“동반성과 능력은 결코 상충되지 않아야 합니다. 우리가 만들고자 하는 것은 감정을 이해하고 진정한 동반자가 되며, 동시에 신뢰할 수 있게 작업을 완수하는 로봇입니다.”

22,000+ 스타, 1,000+ 플러그인, 14개 플랫폼. AstrBot은 이미 많은 것을 증명했습니다. IM 챗봇을 계획하고 있다면, AstrBot부터 시작해보세요.

🔗 관련 정보

공식 사이트: https://astrbot.app
GitHub: https://github.com/Soulter/AstrBot
개발자: AstrBotDevs
주 언어: Python
지원 플랫폼: QQ, Telegram, Discord, Slack, WeChat Work, Feishu, DingTalk, WeChat Official Accounts, LINE, Misskey, Satori, WhatsApp (Coming Soon)
LLM 지원: OpenAI, Anthropic, Google Gemini, Moonshot AI, Zhipu AI, DeepSeek, Ollama, LM Studio 등

탄생 배경: 2022년부터 쌓아온 성숙한 프로젝트

14개 메시징 플랫폼 통합

공식 지원 플랫폼

커뮤니티 플러그인으로 확장

다중 LLM 지원: 상용부터 셀프 호스팅까지

상용 LLM

셀프 호스팅

중국 AI 서비스

OpenAI 호환 API

LLMOps 플랫폼 통합

Dify 통합

Alibaba Cloud Bailian

Coze

AI 기능: 멀티모달부터 주도적 에이전트까지

멀티모달 지원

Agent & MCP

Skills 시스템

지식 베이스

페르소나 설정

자동 컨텍스트 압축

롤플레이 & 감정적 동반자

주도적 에이전트 (Proactive Agent)

1,000+ 커뮤니티 플러그인

인기 플러그인 카테고리

Agent Sandbox: 안전한 코드 실행

WebUI & ChatUI

관리자 UI

ChatUI

음성 기능: STT & TTS

STT (Speech-to-Text)

TTS (Text-to-Speech)

배포 방법: 개발부터 프로덕션까지

1. uv 원클릭 배포 (권장)

2. Docker / Docker Compose

3. RainYun 원클릭 클라우드 배포

4. AstrBot App

5. AstrBot Launcher

6. Replit

7. AUR (Arch Linux)

8. 패널 기반 배포

아키텍처 개요

OpenClaw 대안으로서의 AstrBot

실제 사용 시나리오

시나리오 1: 멀티 플랫폼 고객 지원

시나리오 2: 개인 AI 비서

시나리오 3: 롤플레이 챗봇

시나리오 4: 커뮤니티 관리 봇

커뮤니티와 생태계

활발한 개발

중국어 문서

플러그인 마켓플레이스

마치며: 감정과 능력의 공존

🔗 관련 정보