QQ, 텔레그램, 위챗 등 메신저에 연결되는 오픈소스 AI 에이전트 챗봇 플랫폼
중간맛 분석
Python 기반의 올인원 챗봇 프레임워크로, OpenAI/Anthropic/Gemini/DeepSeek 등 주요 LLM과 QQ/Telegram/WeChat/Slack/Discord 등 15+ 메신저를 지원합니다. 이미지 인식, 음성 변환, 플러그인 생태계(1000+), MCP, Agent Sandbox 같은 고급 기능을 갖추고 있으며, uv 설치(한 줄), , 클라우드 배포 등 다양한 배포 방식을 제공합니다. 웹 UI와 데스크톱 앱도 지원해서 즉시 운영 가능한 수준입니다.
이런 레포예요
이럴 때 쓰면 좋아요
- 메신저(카톡, QQ, 텔레그램) 속 개인 AI 비서 구축
- 고객 서비스 자동화 및 FAQ 챗봇 운영
- 팀 협업 플랫폼(Slack, Feishu) 내 업무 자동화 어시스턴트
핵심 기능
대안 대비 차별점
단일 메신저만 지원하는 기존 봇과 달리, 한 번 설정하면 QQ, Telegram, Discord, Slack, WeChat 등 모든 플랫폼에서 동일한 AI 에이전트를 자동으로 운영할 수 있으며, Dify/Coze 같은 LLMOps 플랫폼과 통합해 저코드로 복잡한 워크플로우를 구성할 수 있습니다.
준비물
- Python 3.12 이상
- uv 또는 Docker (선택)
- LLM API 키 (OpenAI/Gemini/등)
- 메신저 플랫폼 계정 (QQ/Telegram/등)
바로 시작하기
- uv 환경에서 한 줄 설치 (Python 3.12 필수)
uv tool install astrbot --python 3.12
- 첫 실행 시 초기화
astrbot init
- AstrBot 실행
astrbot run
-
웹 UI 접속 후 AI 모델(OpenAI/Gemini 등) 설정
-
메신저 어댑터(QQ/Telegram 등) 연동 설정
-
메신저에서 봇과 대화 시작
(참고: Docker 배포나 다른 배포 방식은 공식 문서 참조)
별 추이 · 7일
활용성 · 따라 만들기 좋은가
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2022년 생성
이 레포에 깃밥 배지 달기
[](https://www.gitbap.com/r/AstrBotDevs/AstrBot)🔌 클로드에서 바로 써보기
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기