HKUDS/nanobot

🐈 nanobot은 OpenClaw, Claude Code, 그리고 Codex의 정신을 계승한 오픈 소스(open-source)이자 초경량(ultra-lightweight) AI 에이전트(agent)입니다. 채팅 채널, 메모리(memory), MCP 및 실질적인 배포 경로를 지원하면서도 핵심 에이전트 루프(agent loop)를 작고 읽기 쉽게 유지하여, 최소한의 오버헤드(overhead)로 로컬 설정부터 장기 실행되는 개인용 에이전트까지 구축할 수 있습니다.

2026-05-15🚀 v0.2.0 출시—턴(turn) 간 지속적인 목표 유지, WebUI가 이제 wheel 내부에 포함됨, 엔드 투 엔드(end to end) 이미지 생성, /goal을 통한 5개의 새로운 프로바이더(provider), 그리고 실제 에이전트 루프(agent-loop) 리팩토링(refactor)이 적용되었습니다. 자세한 내용은 릴리스 노트(release notes)를 참조하세요.
2026-05-14🎯 장기 목표, 가시적인 다단계 진행 상황, 채팅 내 장기 미션(long-horizon missions)을 위한 /goal 기능.

2026-05-13🧠 답변 전 스트리밍 추론(Streaming reasoning), 자동 백업 모델, 더 부드러운 플러그인(plug-in) 재연결.
2026-05-12🎛️ WebUI 배지(badge)가 포함된 저장된 모델 프리셋(presets), 더 간단한 플러그인 도구, 더 조용한 Feishu 토픽 스레드.
2026-05-11🖥️ NVIDIA NIM 지원, 터미널 봇 이름 및 아이콘, 스트리밍 추론 및 MiMo 토글 명확성.
2026-05-09🖼️ 더 선명한 이미지 재생, 설정(Settings)에서 직접 가져오는(BYO) 웹 검색 키, 깔끔하게 라우팅되는 Feishu 스레드.
2026-05-08✨ 인라인(Inline) 채팅 이미지, 재설계된 설정(Settings) 및 키, 가시적인 히스토리(history)와 정렬된 Dream 메모리.
2026-05-07📜 WebUI의 로케일(Locale) 인식 슬래시 팔레트(slash palette), LAN 로그인, 충실한 HTTP 스트리밍 응답.
2026-05-06🧩 조정 가능한 도구 힌트(tool hint), 더 안정적인 음성 및 플러그인 시작, 유지되는 일정 및 알림.
2026-05-05🛡️ 알 수 없는 Telegram 채팅에 대한 조용한 거부, Dream 정리, 더 완전한 자동화 요약.

이전 뉴스

2026-05-04🔐 더 안전한 DingTalk 외부 미디어 링크, 지속 가능한 cron 영속성 (persistence), DeepSeek 다듬기.
2026-05-03⚙️ 예측 가능한 shell 허용 목록 (allow-list) 동작, 답장 중 격리된 채팅, 더 깔끔한 대화형 재시도.
2026-05-02🐈 LongCat 지원, 더 스마트한 토큰 크기 힌트, 더 명확한 번들 업그레이드 안내.
2026-05-01☁️ 네이티브 AWS Bedrock 프로바이더 (provider), 더 긴밀한 헬퍼 핸드오프 (helper handoffs) 및 범위가 지정된 세션 파일.
2026-04-30💬 답장과 주제를 준수하는 Feishu 스레드 (threads), 소스 편집 시 WhatsApp 브리지 (bridge) 새로고침.
2026-04-29🚀 v0.1.5.post3 출시 — Feishu, Discord, Slack, Teams에서의 더 스마트한 스레드; DeepSeek-V4; Hugging Face & Olostep 선택지, /history 명령, 그리고 더 안정적인 긴 채팅. 자세한 내용은 릴리스 노트 (release notes)를 참조하세요.
2026-04-28🌐 Olostep 웹 검색, Hugging Face 프로바이더 (provider), 더 안전한 워크스페이스 도구 중단.
2026-04-27💬 /history 명령, 더 스마트한 세션 재생 제한, 더 부드러운 Discord / Slack 스레드.
2026-04-26🧭 자연스러운 cron 알림, 스레드 인지 재시작, 더 안전한 로컬 프로바이더 (provider) 및 shell 동작.
2026-04-25🧩 ask_user

선택지 (choices), macOS LaunchAgent 배포, MSTeams 만료된 참조 (stale-reference) 정리.2026-04-24🎥 채널용 비디오 첨부, DeepSeek 사고 (thinking) 제어, 더 빠른 문서 시작.2026-04-23🧵 Discord 스레드 세션, Telegram 인라인 버튼, 구조화된 도구 진행 상황 업데이트.2026-04-22🔎 GitHub Copilot GPT-5 / o-series 지원, 설정 가능한 웹 페치 (web fetch), WebUI 이미지 업로드.2026-04-21🚀 v0.1.5.post2 출시 — Windows 및 Python 3.14 지원, Office 문서 읽기, OpenAI 호환 API를 위한 SSE 스트리밍 (SSE streaming), 그리고 세션, 메모리 및 채널 전반에 걸친 더 강력한 신뢰성. 자세한 내용은 릴리스 노트를 참조하세요.2026-04-20🎨 Kimi K2.6 지원, Telegram 긴 메시지 분할, WebUI 타이포그래피 및 다크 모드 개선.2026-04-19🌐 WebUI 국제화 (i18n) 로케일 스위처, 자동 복구가 포함된 원자적 세션 쓰기 (atomic session writes).2026-04-18🧪 초기 WebUI 채팅, 더 스마트한 설정 마법사 메뉴, WebSocket 멀티 채팅 멀티플렉싱 (multi-chat multiplexing).2026-04-17🪟 Windows 및 Python 3.14 CI, Dream 계보 메모리 (line-age memory), 이메일 셀프 루프 방지.2026-04-16📡 OpenAI 호환 API를 위한 SSE 스트리밍 (SSE streaming), Discord 채널 허용 목록 (allow-list).2026-04-15🎛️ LM Studio 및 Nullable API 키, MiniMax 사고 (thinking) 엔드포인트, 런타임 SelfTool.2026-04-14🚀 v0.1.5.post1 출시 — Dream 기술 발견, 턴 중간 후속 주입 (mid-turn follow-up injection), WebSocket 채널 및 더 깊은 채널 통합. 자세한 내용은 릴리스 노트를 참조하세요.2026-04-13🛡️ 에이전트 턴 강화 — 사용자 메시지 조기 저장, 자동 압축 시 활성 작업 건너뛰기.2026-04-12🔒 Lark 글로벌 도메인 지원, Dream이 발견된 기술을 학습, 쉘 샌드박스 (shell sandbox) 강화.2026-04-11⚡ 컨텍스트 압축 (Context compact)이 세션을 즉시 축소; Kagi 웹 검색; QQ 및 WeCom 전체 미디어 지원.2026-04-10📓 노트북 편집 도구, 다중 MCP 서버, Feishu 스트리밍 및 완료 이모지 (done-emoji).2026-04-09🔌 WebSocket 채널, 통합 크로스 채널 세션, disabled_skills

config.2026-04-08📤 API 파일 업로드, Responses 폴백 (fallback) 기능을 포함한 OpenAI 추론 자동 라우팅 (auto-routing).2026-04-07🧠 Anthropic 적응형 사고 (adaptive thinking), 도구 (tools)로 노출된 MCP 리소스 및 프롬프트 (prompts).2026-04-06🛰️ Langfuse 관측성 (observability), 통합 Whisper 전사 (transcription), 이메일 첨부 파일.2026-04-05🚀 v0.1.5 출시 — 더 견고해진 장기 실행 작업 (long-running tasks), Dream 2단계 메모리 (two-stage memory), 프로덕션 준비 완료된 샌드박싱 (sandboxing) 및 프로그래밍 에이전트 SDK (programming Agent SDK). 자세한 내용은 릴리스 노트 (release notes)를 참조하세요.2026-04-04🚀 Jinja2 응답 템플릿 (response templates), Dream 메모리 강화, 더 스마트한 재시도 (retry) 처리.2026-04-03🧠 Xiaomi MiMo 프로바이더 (provider), 사고의 사슬 (chain-of-thought) 추론 가시화, Telegram UX 개선.2026-04-02🧱 장기 실행 작업 (long-running tasks)의 신뢰성 향상 — 핵심 런타임 (core runtime) 강화.2026-04-01🔑 GitHub Copilot 인증 복구; 더 엄격한 워크스페이스 (workspace) 경로; OpenRouter Claude 캐싱 수정.2026-03-31🛰️ WeChat 멀티모달 (multimodal) 정렬, Discord/Matrix 개선, Python SDK 파사드 (facade), MCP 및 도구 (tool) 수정.2026-03-30🧩 OpenAI 호환 API 강화; 조합 가능한 에이전트 생명주기 훅 (agent lifecycle hooks).2026-03-29💬 WeChat 음성, 타이핑, QR/미디어 탄력성; 고정 세션 (fixed-session) OpenAI 호환 API.2026-03-28📚 프로바이더 (provider) 문서 갱신; 스킬 템플릿 (skill template) 문구 수정.2026-03-27🚀 v0.1.4.post6 출시 — 아키텍처 디커플링 (architecture decoupling), litellm 제거, 엔드 투 엔드 스트리밍 (end-to-end streaming), WeChat 채널, 그리고 보안 수정. 자세한 내용은 릴리스 노트 (release notes)를 참조하세요.2026-03-26🏗️ 에이전트 러너 (Agent runner) 추출 및 생명주기 훅 (lifecycle hooks) 통합; 경계에서의 스트림 델타 병합 (stream delta coalescing).2026-03-25🌏 StepFun 프로바이더 (provider), 설정 가능한 시간대 (timezone), Gemini 사고 서명 (thought signatures).2026-03-24🔧 WeChat 호환성, Feishu CardKit 스트리밍, 테스트 스위트 (test suite) 구조 재편.2026-03-23🔧 플러그인을 위한 명령 라우팅 (command routing) 리팩토링, WhatsApp/WeChat 미디어, 통합 채널 로그인 CLI.2026-03-22⚡ 엔드 투 엔드 스트리밍 (end-to-end streaming), WeChat 채널, Anthropic 캐시 최적화, /status 명령.2026-03-21🔒 litellm을 네이티브 openai + anthropic으로 교체

SDKs (소프트웨어 개발 키트). 커밋을 참조하세요.2026-03-20🧙 대화형 설정 마법사 — 제공자(provider)를 선택하고 모델 자동 완성 기능을 사용하면 바로 시작할 수 있습니다.2026-03-19💬 부하 상황에서 Telegram의 복원력이 향상되었으며, Feishu에서 코드 블록이 이제 제대로 렌더링됩니다.2026-03-18📷 이제 Telegram을 통해 URL로 미디어를 전송할 수 있습니다. Cron 스케줄이 읽기 쉬운 상세 정보를 표시합니다.2026-03-17✨ Feishu 포맷팅 개선, 작업 완료 시 Slack 반응 추가, 커스텀 엔드포인트(custom endpoints)의 추가 헤더 지원, 그리고 더욱 안정적인 이미지 처리.2026-03-16🚀 v0.1.4.post5 출시 — 더 강력한 신뢰성과 채널 지원, 그리고 더욱 믿을 수 있는 일상적인 경험을 제공하기 위해 개선에 집중한 릴리스입니다. 자세한 내용은 릴리스 노트(release notes)를 참조하세요.2026-03-15🧩 DingTalk 리치 미디어(rich media), 더 스마트해진 내장 스킬(built-in skills), 그리고 더 깔끔해진 모델 호환성.2026-03-14💬 채널 플러그인(Channel plugins), Feishu 답장, 그리고 더욱 안정적인 MCP, QQ 및 미디어 처리.2026-03-13🌐 멀티 제공자(Multi-provider) 웹 검색, LangSmith, 그리고 광범위한 신뢰성 개선.2026-03-12🚀 VolcEngine 지원, Telegram 답장 컨텍스트, /restart

, 그리고 더 견고한 메모리.2026-03-11🔌 WeCom, Ollama, 더 깔끔한 검색(discovery), 그리고 더 안전한 도구(tool) 동작.2026-03-10🧠 토큰 기반 메모리 (Token-based memory), 공유 재시도 (shared retries), 그리고 더 깔끔한 게이트웨이(gateway) 및 Telegram 동작.2026-03-09💬 Slack 스레드 개선 및 더 나은 Feishu 오디오 호환성.2026-03-08🚀 v0.1.4.post4 출시 — 더 안전한 기본값, 더 나은 멀티 인스턴스(multi-instance) 지원, 더 견고한 MCP, 그리고 주요 채널 및 제공자(provider) 개선을 포함한 신뢰성 중심의 릴리스입니다. 자세한 내용은 릴리스 노트를 참조하세요.2026-03-07🚀 Azure OpenAI 제공자, WhatsApp 미디어, QQ 그룹 채팅, 그리고 추가적인 Telegram/Feishu 개선.2026-03-06🪄 더 가벼운 제공자(providers), 더 스마트한 미디어 처리, 그리고 더 견고한 메모리 및 CLI 호환성.2026-03-05⚡️ Telegram 초안 스트리밍 (draft streaming), MCP SSE 지원, 그리고 더 광범위한 채널 신뢰성 수정.2026-03-04🛠️ 의존성(Dependency) 정리, 더 안전한 파일 읽기, 그리고 또 다른 테스트 및 Cron 수정.2026-03-03🧠 더 깔끔한 사용자 메시지 병합, 더 안전한 멀티모달 (multimodal) 저장, 그리고 더 강력한 Cron 가드.2026-03-02🛡️ 더 안전한 기본 액세스 제어, 더 견고한 Cron 재로드, 그리고 더 깔끔한 Matrix 미디어 처리.2026-03-01🌐 웹 프록시 (Web proxy) 지원, 더 스마트한 Cron 알림, 그리고 Feishu 리치 텍스트 (rich-text) 파싱 개선.2026-02-28🚀 v0.1.4.post3 출시 — 더 깔끔한 컨텍스트, 강화된 세션 히스토리, 그리고 더 스마트한 에이전트(agent). 자세한 내용은 릴리스 노트를 참조하세요.2026-02-27🧠 실험적인 사고 모드 (thinking mode) 지원, DingTalk 미디어 메시지, Feishu 및 QQ 채널 수정.2026-02-26🛡️ 세션 포이즈닝 (Session poisoning) 수정, WhatsApp 중복 제거 (dedup), Windows 경로 가드, Mistral 호환성.2026-02-25🧹 새로운 Matrix 채널, 더 깔끔한 세션 컨텍스트, 워크스페이스 템플릿 자동 동기화.2026-02-24🚀 v0.1.4.post2 출시 — 재설계된 하트비트 (heartbeat), 프롬프트 캐시 (prompt cache) 최적화, 그리고 강화된 제공자 및 채널 안정성을 갖춘 신뢰성 중심의 릴리스입니다.

자세한 내용은 릴리스 노트 (release notes)를 참조하세요.

2026-02-23
🔧 가상 도구 호출 (virtual tool-call) 하트비트 (heartbeat), 프롬프트 캐시 (prompt cache) 최적화, Slack mrkdwn 수정.

2026-02-22
🛡️ Slack 스레드 격리 (thread isolation), Discord 타이핑 수정, 에이전트 (agent) 신뢰성 개선.

2026-02-21
🎉 v0.1.4.post1 출시 — 새로운 제공자 (providers), 채널 전반의 미디어 지원, 그리고 주요 안정성 개선. 자세한 내용은 릴리스 노트를 참조하세요.

2026-02-20
🐦 Feishu에서 이제 사용자로부터 멀티모달 (multimodal) 파일을 수신합니다. 내부적으로 더욱 신뢰할 수 있는 메모리 (memory) 시스템을 갖추었습니다.

2026-02-19
✨ Slack에서 이제 파일을 전송하며, Discord는 긴 메시지를 분할하고, 서브 에이전트 (subagents)가 CLI 모드에서 작동합니다.

2026-02-18
⚡️ nanobot이 이제 VolcEngine, MCP 커스텀 인증 헤더 (custom auth headers), 그리고 Anthropic 프롬프트 캐싱 (prompt caching)을 지원합니다.

2026-02-17
🎉 v0.1.4 출시 — MCP 지원, 진행 상황 스트리밍 (progress streaming), 새로운 제공자, 그리고 다중 채널 개선 사항을 포함합니다. 자세한 내용은 릴리스 노트를 참조하세요.

2026-02-16
🦞 nanobot이 이제 ClawHub 스킬을 통합했습니다 — 공개 에이전트 스킬을 검색하고 설치할 수 있습니다.

2026-02-15
🔑 nanobot이 이제 OAuth 로그인을 지원하는 OpenAI Codex 제공자를 지원합니다.

2026-02-14
🔌 nanobot이 이제 MCP를 지원합니다! 자세한 내용은 MCP 섹션을 참조하세요.

2026-02-13
🎉 v0.1.3.post7 출시 — 보안 강화 및 여러 개선 사항이 포함되었습니다.
보안 문제를 해결하려면 최신 버전으로 업그레이드하십시오. 자세한 내용은 릴리스 노트를 참조하세요.

2026-02-12
🧠 메모리 (memory) 시스템 재설계 — 더 적은 코드, 더 높은 신뢰성. 이에 대한 토론에 참여하세요!

2026-02-11
✨ 향상된 CLI 경험 및 MiniMax 지원 추가!

2026-02-10
🎉 개선 사항이 포함된 v0.1.3.post6 출시! 업데이트 노트와 로드맵을 확인하세요.

2026-02-09
💬 Slack, Email, QQ 지원 추가 — nanobot이 이제 여러 채팅 플랫폼을 지원합니다!

2026-02-08
🔧 제공자 (Providers) 리팩터링 — 이제 새로운 LLM 제공자를 추가하는 데 단 2단계만 필요합니다! 여기서 확인하세요.

2026-02-07
🚀 Qwen 지원 및 여러 주요 개선 사항이 포함된 v0.1.3.post5 출시!

여기에서 자세한 내용을 확인하세요.

2026-02-06
✨ Moonshot/Kimi 프로바이더 (provider), Discord 연동 및 보안 강화 (security hardening) 기능이 추가되었습니다!

2026-02-05
✨ Feishu 채널, DeepSeek 프로바이더 (provider) 및 예약된 작업 (scheduled tasks) 지원이 강화되었습니다!

2026-02-04
🚀 멀티 프로바이더 (multi-provider) 및 Docker 지원을 포함한 v0.1.3.post4가 출시되었습니다! 여기에서 자세한 내용을 확인하세요.

2026-02-03
⚡ 로컬 LLM 지원을 위한 vLLM 통합 및 자연어 작업 스케줄링 (natural language task scheduling) 기능이 개선되었습니다!

2026-02-02
🎉 nanobot이 공식 출시되었습니다! 🐈 nanobot을 사용해 보세요!

초경량 (Ultra-lightweight): 작고 읽기 쉬운 코어 (core)를 통해 안정적인 장기 실행 에이전트 (agent) 동작을 보장합니다.
연구 준비 완료 (Research-ready): 코드베이스 (codebase)를 연구, 수정 및 확장하기에 충분할 만큼 의도적으로 단순하게 설계했습니다.
실용적 (Practical): 채팅 채널, API, 메모리 (memory), MCP 및 배포 경로가 이미 구축되어 있습니다.
해킹 가능 (Hackable): 거대한 랜딩 페이지 대신 리포지토리 (repo) 문서를 통해 빠르게 시작하고 더 깊게 파고들 수 있습니다.

중요 사항

최신 기능과 실험적인 기능을 원하신다면 소스 코드에서 설치하세요.

가장 안정적인 일상적 경험을 원하신다면 PyPI 또는 uv를 통해 설치하세요.

소스 코드에서 설치

git clone https://github.com/HKUDS/nanobot.git
cd nanobot
pip install -e .

uv로 설치

uv tool install nanobot-ai

PyPI에서 설치

pip install nanobot-ai

1. 초기화 (Initialize)

nanobot onboard

2. 설정 (Configure) (~/.nanobot/config.json)

설정 파일의 다음 두 부분을 구성하세요 (기타 옵션은 기본값이 적용됩니다). 기존 설정 파일을 통째로 교체하는 대신, 다음 블록을 기존 설정에 추가하거나 병합하세요.

API 키 설정 (예: OpenRouter, 글로벌 사용자에게 권장됨):