개요
AstrBot은 메신저(IM) 앱에 LLM 에이전트를 연결해 주는 오픈소스 챗봇·에이전트 플랫폼이다. 개인 AI 동반자, 고객 상담, 자동화 비서, 사내 지식베이스를 “메신저 워크플로 안에서” 운영 가능한 형태로 만드는 것이 목표다. 저장소 설명은 스스로를 openclaw의 대안(alternative)으로 내세운다. 중국 QQ 생태계에서 출발했고(2022-12 생성), 2026-10-04 기준 GitHub 별 약 4.1만, 포크 약 3천, 오픈 이슈 약 1.6천이며 라이선스는 AGPL-3.0이다. 수치는 GitHub API 조회 시점 값이다.
핵심 사양
| 항목 | 내용 |
|---|---|
| 언어·요구 사양 | Python 3.12+, 패키지 관리는 uv, 린트는 ruff |
| 최신 릴리스 | v4.29.0-beta.1 (2026-10-01) |
| 설치 | uv tool install astrbot --python 3.12 → astrbot init → astrbot run |
| 배포 방식 | uv CLI, Docker/Compose, 데스크톱 앱(AstrBot-desktop), Launcher(멀티 인스턴스), 宝塔·1Panel·CasaOS, k8s 매니페스트 |
| 관리 UI | WebUI(설정·플러그인)와 에이전트 샌드박스·웹 검색이 내장된 Web ChatUI |
기능
- 대화·에이전트: 멀티모달, 에이전트, moc-mcp 연동, 스킬, 지식베이스, 페르소나 설정, 컨텍스트 자동 압축.
- 외부 에이전트 플랫폼 연동: Dify, 알리바바 클라우드 百炼, Coze를 백엔드로 붙일 수 있다.
- 플러그인: 마켓플레이스에서 1000개 이상을 원클릭 설치한다고 밝힌다(개발자 주장).
- 에이전트 샌드박스: 코드·셸 실행을 격리하고 세션 단위로 자원을 재사용한다. 별도 compose(
compose-with-shipyard.yml)가 있다. - i18n: WebUI 다국어 지원.
지원 범위
- 메신저(공식): QQ, OneBot v11, Telegram, 企业微信·WeCom AI Bot, 微信公众号, 飞书(Lark), 钉钉, Slack, Discord, LINE, Satori, KOOK, Misskey, Mattermost. WhatsApp은 준비 중이다. Matrix·Rocket.Chat·VoceChat은 커뮤니티 어댑터다.
- LLM: OpenAI 호환, Anthropic, Gemini, Moonshot, Zhipu, DeepSeek, Ollama·LM Studio(자체 호스팅), SiliconFlow·ModelScope·OneAPI와 여러 API 게이트웨이.
- 음성: STT는 Whisper·SenseVoice·MiMo Omni, TTS는 OpenAI·Gemini·Edge·Azure·FishAudio·GPT-SoVITS·Minimax·Volcano 등.
평가와 주의점
- 서구권 에이전트 하네스(hermes-agent, openclaw)가 CLI·TUI 중심이라면 AstrBot은 메신저 어댑터와 중국권 서비스(QQ·飞书·钉钉·百炼) 연동이 강점이다. 아시아권 메신저로 봇을 운영하려는 경우에 맞는다.
- AGPL-3.0이라 수정본을 네트워크 서비스로 제공하면 소스 공개 의무가 생긴다. 사내·상용 도입 전 확인이 필요하다.
- 이 노트는 README와 GitHub 메타데이터만 근거로 한다. 플러그인 수·성능·보안 샌드박스 수준은 직접 검증하지 않았다. README의 일부 서비스 링크에는 제휴(referral) 코드가 붙어 있다.