nanobot: 4,000줄로 구현한 초경량 AI 어시스턴트

nanobot 아키텍처 개요

AI 에이전트 프로젝트가 폭발적으로 늘어나면서, 코드베이스도 덩치를 키워가고 있습니다. 수십만 줄의 코드, 복잡한 의존성, 이해하기 힘든 아키텍처… 연구자나 개발자가 “이게 정말 필요한 걸까?”라고 묻는 건 자연스러운 일입니다.

홍콩대학교 데이터과학연구소(HKUDS)가 공개한 nanobot은 이 질문에 대한 대답입니다. OpenClaw에서 영감을 받아 탄생한 이 프로젝트는 단 4,000줄의 핵심 코드로 완전한 AI 어시스턴트를 구현했습니다. Clawdbot의 43만 줄이 넘는 코드와 비교하면 99%나 작습니다.

🎯 철학: “적은 것이 더 많은 것”

nanobot의 핵심 철학은 명확합니다. 연구자를 위한 깔끔한 코드입니다.

많은 AI 에이전트 프로젝트가 기능 추가와 확장을 반복하며 “비대해지는” 문제를 겪습니다. 새로운 기능이 필요할 때마다 코드를 추가하고, 버그를 수정하고, 의존성을 늘리다 보면 어느 순간 프로젝트 전체를 이해하기 어려워집니다.

nanobot은 다른 길을 선택했습니다.

가독성 우선: 처음 읽는 사람도 핵심 로직을 빠르게 파악할 수 있어야 합니다.
최소 의존성: 꼭 필요한 것만 남기고 모두 제거했습니다.
연구 친화적: 실험과 수정이 쉬워야 새로운 아이디어를 빠르게 검증할 수 있습니다.

결과는 놀랍습니다. 에이전트의 핵심 기능—LLM 통합, 채널 연동, 툴 실행—을 4,000줄 안에 담아냈습니다.

⚡ 핵심 기능

멀티 채널 지원

nanobot은 9개 이상의 메시징 플랫폼을 지원합니다:

메신저: Telegram, Discord, WhatsApp, Matrix, QQ, DingTalk
협업: Slack, Feishu
기타: Email

각 채널은 독립적인 모듈로 구현되어 있어, 새로운 플랫폼 추가도 쉽습니다.

MCP (Model Context Protocol) 지원

nanobot GitHub 미리보기

MCP는 AI 모델이 외부 도구와 컨텍스트를 사용할 수 있게 하는 표준 프로토콜입니다. nanobot은 MCP를 완벽하게 지원하여:

외부 데이터 소스 연동
커스텀 툴 개발 및 통합
다른 MCP 호환 에이전트와의 상호운용

을 모두 가능하게 합니다.

다중 LLM 프로바이더

하나의 LLM에 종속되지 않습니다:

OpenRouter: 100개 이상의 모델에 단일 API로 접근
Anthropic Claude: 직접 통합으로 최적의 성능
OpenAI: GPT 시리즈 지원
DeepSeek, Moonshot, Qwen: 중국 모델 생태계
Mistral: 유럽 오픈소스 모델
vLLM: 자체 호스팅 모델 서빙

ClawHub 스킬 통합

nanobot은 ClawHub의 공개 에이전트 스킬을 설치해 기능을 확장할 수 있습니다. 커뮤니티가 만든 다양한 스킬을 원클릭으로 추가하세요.

실험적 사고 모드 (Thinking Mode)

지원하는 모델에서 추론 과정을 자세히 볼 수 있는 사고 모드를 실험적으로 지원합니다. reasoning_effort 설정으로 깊이를 조절할 수 있습니다.

서브에이전트와 /stop 명령

복잡한 작업을 서브에이전트에 위임할 수 있으며, 진행 중인 작업은 /stop 명령으로 언제든 취소 가능합니다.

🔧 기술적 깊이보기

세션 안전장치들

v0.1.4.post3에서는 세션 안정성을 크게 강화했습니다:

에이전트 루프 강화: 빈 메시지를 필터링하고 LLM 에러 루프를 방지합니다.
컨텍스트 노이즈 감소: 런타임 메타데이터를 세션 히스토리와 분리했습니다.
이미지 처리 최적화: Base64 인코딩된 이미지는 히스토리에서 제거하여 컨텍스트 길이를 관리합니다.

Matrix 채널 완전 지원

Matrix/Element 프로토콜을 완전히 지원합니다. 종단간 암호화(E2EE)가 적용된 방에서도 정상 작동합니다.

프로바이더 호환성 개선

Mistral 모델과의 호환성 문제를 해결했고, 리스트 타입 툴 인자도 올바르게 처리합니다.

📦 최신 업데이트 (v0.1.4.post3)

2026년 2월 28일에 릴리스된 최신 버전의 주요 변경사항입니다:

세션 안전성

세션 포이즈닝 방지 로직 추가
빈 메시지 필터링으로 무한 루프 차단

채널별 수정

WhatsApp 메시지 중복 제거
Feishu, DingTalk, Telegram, QQ 채널 버그 수정
Matrix 채널 E2EE 지원 강화

기타

Windows 경로 처리 가드 추가
사고 모드(Thinking Mode) 실험적 지원
서브에이전트 /stop 명령 추가

최근 7일간(2월 25일 기준) 커밋만 봐도 활발한 개발이 진행되고 있습니다.

💡 활용 시나리오

24/7 실시간 시장 분석

주식, 암호화폐, 원자재 시장을 24시간 모니터링하고 중요한 변동을 알림으로 받으세요. nanobot은 데이터 소스를 수집하고, 분석하고, 요약하여 전달합니다.

풀스택 소프트웨어 엔지니어

코드 작성, 리팩토링, 버그 수정, 문서화까지. nanobot은 파일 시스템에 접근하고 터미널 명령을 실행하며 실제 개발 작업을 수행할 수 있습니다.

스마트 데일리 루틴 매니저

아침 브리핑, 일정 관리, 할 일 추적을 자동화하세요. 캘린더와 연동하여 중요한 미팅을 놓치지 않도록 도와줍니다.

개인 지식 어시스턴트

로컬 문서, 노트, 웹 검색 결과를 통합하여 개인 지식 베이스를 구축하고 관리합니다. “지난달에 읽은 논문 중 BERT 관련된 거 찾아줘” 같은 질문에 답할 수 있습니다.

🚀 빠른 시작

nanobot은 “원클릭 배포”를 목표로 합니다:

# 저장소 클론
git clone https://github.com/HKUDS/nanobot.git
cd nanobot

# 설치 및 실행
pip install -r requirements.txt
python nanobot.py

환경 변수만 설정하면 바로 실행됩니다. Docker를 사용한다면 더 간단합니다.

마치며

nanobot은 “적은 것이 더 많은 것”이라는 철학을 증명합니다. 4,000줄의 코드로 완전한 AI 어시스턴트를 만들 수 있다는 것은, 우리가 불필요하게 복잡하게 만들고 있었는지 돌아보게 합니다.

연구자를 위한 깔끔한 코드, 개발자를 위한 쉬운 확장, 사용자를 위한 빠른 배포. nanobot은 이 세 가지를 모두 달성했습니다.

AI 에이전트의 핵심이 무엇인지 궁금하다면, nanobot의 코드를 읽어보세요. 4,000줄이면 저녁 몇 시간이면 전체를 파악할 수 있습니다. 그것이 바로 nanobot이 주는 가장 큰 가치입니다.

🔗 참고 자료

GitHub 저장소: https://github.com/HKUDS/nanobot
HKUDS: Hong Kong University Data Science Institute
OpenClaw: nanobot의 영감을 준 프로젝트