AstrBot
무엇인가
AstrBot은 메신저 계정을 LLM 에이전트의 입출력 채널로 쓰는 파이썬 애플리케이션이다. 개인용 AI 컴패니언, 고객 응대 봇, 자동화 어시스턴트, 사내 지식베이스 질의를 같은 코드베이스에서 구성한다. 메신저 어댑터, LLM 연결, 플러그인 실행, 웹 관리 화면이 한 프로세스에 묶여 있다.
어떻게 동작하나
메신저 플랫폼별 어댑터가 수신 메시지를 이벤트로 바꿔 처리 파이프라인에 넣는다. 파이프라인은 페르소나 설정과 대화 컨텍스트를 조립한 뒤 LLM 제공자나 Dify·알리바바 클라우드 바이롄·Coze 같은 외부 에이전트 플랫폼으로 요청을 넘긴다. 응답 생성 과정에 지식베이스 검색과 MCP 도구 호출이 끼어들 수 있고, 컨텍스트가 길어지면 자동으로 압축한다. 코드 실행과 셸 호출은 에이전트 샌드박스에서 세션 단위로 격리해 자원을 재사용한다. 어댑터 등록과 플러그인 설치는 WebUI에서 한다.
무엇과 다른가
Dify나 Coze 같은 에이전트 빌더는 자체 대화 UI와 API를 중심으로 동작한다. AstrBot은 그 앞단을 이미 쓰고 있는 메신저로 옮긴다. QQ, WeChat Work, Feishu, DingTalk, WeChat Official Accounts, Telegram, Slack 계정에 봇을 붙이고, 필요하면 외부 에이전트 플랫폼을 백엔드로 호출한다. 웹 ChatUI와 에이전트 샌드박스, 웹 검색이 기본 구성에 포함되고 인터페이스는 다국어로 표시된다.
어떻게 쓰나
uv가 설치돼 있으면 uv 기반 원클릭 배포로 설치하고, 이후 astrbot 명령으로 갱신한다. 서버 운영에는 Docker 또는 Docker Compose 배포를 쓴다. 데스크톱에서는 AstrBot App이나 AstrBot Launcher를 내려받아 설치한다. 패널 환경이면 BT-Panel, 1Panel, CasaOS 앱 마켓 항목을 쓰고, 소스에서 직접 설치하려면 uv로 수동 배포한다. 설치 후 WebUI에 접속해 메신저 어댑터와 LLM 제공자를 등록한다.
전제와 한계
uv 기반 배포는 uv 설치가 선행돼야 한다. macOS에서는 보안 검사 때문에 astrbot 명령 첫 실행이 10~20초 걸린다. 데스크톱 앱은 ChatUI 중심 사용을 전제로 하고 서버 시나리오에는 권장되지 않는다. 플러그인은 1000개 이상이 배포돼 있으며 WebUI에서 설치한다. 24시간 무중단 배포를 서버 관리 없이 하려면 RainYun 원클릭 클라우드 배포를 쓴다.
관련 논문 5
유사 도구
- chatluna여러 플랫폼의 대규모 언어 모델을 하나의 봇 플러그인으로 연결하고, 확장 가능한 구조와 다양한 출력 형식으로 채팅 서비스를 제공하도록 규율한다.
- onyxLLM 애플리케이션 계층으로, RAG·웹 검색·코드 실행·에이전트를 갖춘 셀프호스팅 AI 채팅 플랫폼이다. 50개 이상 커넥터로 사내 데이터를 색인한다.
- SimpleMemLLM 에이전트에 장기 기억을 붙이는 Python 패키지다. 대화를 원자적 기억으로 압축해 저장하고 의미 기반으로 검색하며, 텍스트와 이미지·오디오·비디오를 함께 다룬다.
- quivrRAG 파이프라인을 YAML 워크플로로 정의해 LLM 앱에 붙이는 Python 라이브러리다. LLM·벡터스토어·파서를 교체할 수 있다.
- cognee에이전트에 세션을 넘어 지속되는 장기 기억을 붙이는 오픈소스 AI 메모리 플랫폼이다. 자체 호스팅 지식 그래프 엔진 위에서 동작한다.
- AutoGPT평문으로 작업을 설명하면 AI 에이전트를 만들어 실행하고 결과를 보고하는 오픈소스 플랫폼이다. 자체 호스팅과 관리형 호스팅을 모두 지원한다.