<div align="center"> <img src="nanobot_logo.png" alt="nanobot" width="500"> <h1>nanobot: Ultra-Lightweight Personal AI Assistant</h1> <p> <a href="https://pypi.org/project/nanobot-ai/"><img src="https://img.shields.io/pypi/v/nanobot-ai" alt="PyPI"></a> <a href="https://pepy.tech/project/nanobot-ai"><img src="https://static.pepy.tech/badge/nanobot-ai" alt="Downloads"></a> <img src="https://img.shields.io/badge/python-≥3.11-blue" alt="Python"> <img src="https://img.shields.io/badge/license-MIT-green" alt="License"> <a href="./COMMUNICATION.md"><img src="https://img.shields.io/badge/Feishu-Group-E9DBFC?style=flat&logo=feishu&logoColor=white" alt="Feishu"></a> <a href="./COMMUNICATION.md"><img src="https://img.shields.io/badge/WeChat-Group-C5EAB4?style=flat&logo=wechat&logoColor=white" alt="WeChat"></a> <a href="https://discord.gg/MnCvHqpUGB"><img src="https://img.shields.io/badge/Discord-Community-5865F2?style=flat&logo=discord&logoColor=white" alt="Discord"></a> </p> </div>

🐈 nanobot is an ultra-lightweight personal AI assistant inspired by OpenClaw.

⚡️ Delivers core agent functionality with 99% fewer lines of code than OpenClaw.

📏 Real-time line count: run bash core_agent_lines.sh to verify anytime.

📢 News

2026-04-02 🧱 Long-running tasks run more reliably — core runtime hardening.
2026-04-01 🔑 GitHub Copilot auth restored; stricter workspace paths; OpenRouter Claude caching fix.
2026-03-31 🛰️ WeChat multimodal alignment, Discord/Matrix polish, Python SDK facade, MCP and tool fixes.
2026-03-30 🧩 OpenAI-compatible API tightened; composable agent lifecycle hooks.
2026-03-29 💬 WeChat voice, typing, QR/media resilience; fixed-session OpenAI-compatible API.
2026-03-28 📚 Provider docs refresh; skill template wording fix.
2026-03-27 🚀 Released v0.1.4.post6 — architecture decoupling, litellm removal, end-to-end streaming, WeChat channel, and a security fix. Please see release notes for details.
2026-03-26 🏗️ Agent runner extracted and lifecycle hooks unified; stream delta coalescing at boundaries.
2026-03-25 🌏 StepFun provider, configurable timezone, Gemini thought signatures.
2026-03-24 🔧 WeChat compatibility, Feishu CardKit streaming, test suite restructured.

<details> <summary>Earlier news</summary>

2026-03-23 🔧 Command routing refactored for plugins, WhatsApp/WeChat media, unified channel login CLI.
2026-03-22 ⚡ End-to-end streaming, WeChat channel, Anthropic cache optimization, /status command.
2026-03-21 🔒 Replace litellm with native openai + anthropic SDKs. Please see commit.
2026-03-20 🧙 Interactive setup wizard — pick your provider, model autocomplete, and you're good to go.
2026-03-19 💬 Telegram gets more resilient under load; Feishu now renders code blocks properly.
2026-03-18 📷 Telegram can now send media via URL. Cron schedules show human-readable details.
2026-03-17 ✨ Feishu formatting glow-up, Slack reacts when done, custom endpoints support extra headers, and image handling is more reliable.
2026-03-16 🚀 Released v0.1.4.post5 — a refinement-focused release with stronger reliability and channel support, and a more dependable day-to-day experience. Please see release notes for details.
2026-03-15 🧩 DingTalk rich media, smarter built-in skills, and cleaner model compatibility.
2026-03-14 💬 Channel plugins, Feishu replies, and steadier MCP, QQ, and media handling.
2026-03-13 🌐 Multi-provider web search, LangSmith, and broader reliability improvements.
2026-03-12 🚀 VolcEngine support, Telegram reply context, /restart, and sturdier memory.
2026-03-11 🔌 WeCom, Ollama, cleaner discovery, and safer tool behavior.
2026-03-10 🧠 Token-based memory, shared retries, and cleaner gateway and Telegram behavior.
2026-03-09 💬 Slack thread polish and better Feishu audio compatibility.
2026-03-08 🚀 Released v0.1.4.post4 — a reliability-packed release with safer defaults, better multi-instance support, sturdier MCP, and major channel and provider improvements. Please see release notes for details.
2026-03-07 🚀 Azure OpenAI provider, WhatsApp media, QQ group chats, and more Telegram/Feishu polish.
2026-03-06 🪄 Lighter providers, smarter media handling, and sturdier memory and CLI compatibility.
2026-03-05 ⚡️ Telegram draft streaming, MCP SSE support, and broader channel reliability fixes.
2026-03-04 🛠️ Dependency cleanup, safer file reads, and another round of test and Cron fixes.
2026-03-03 🧠 Cleaner user-message merging, safer multimodal saves, and stronger Cron guards.
2026-03-02 🛡️ Safer default access control, sturdier Cron reloads, and cleaner Matrix media handling.
2026-03-01 🌐 Web proxy support, smarter Cron reminders, and Feishu rich-text parsing improvements.
2026-02-28 🚀 Released v0.1.4.post3 — cleaner context, hardened session history, and smarter agent. Please see release notes for details.
2026-02-27 🧠 Experimental thinking mode support, DingTalk media messages, Feishu and QQ channel fixes.
2026-02-26 🛡️ Session poisoning fix, WhatsApp dedup, Windows path guard, Mistral compatibility.
2026-02-25 🧹 New Matrix channel, cleaner session context, auto workspace template sync.
2026-02-24 🚀 Released v0.1.4.post2 — a reliability-focused release with a redesigned heartbeat, prompt cache optimization, and hardened provider & channel stability. See release notes for details.
2026-02-23 🔧 Virtual tool-call heartbeat, prompt cache optimization, Slack mrkdwn fixes.
2026-02-22 🛡️ Slack thread isolation, Discord typing fix, agent reliability improvements.
2026-02-21 🎉 Released v0.1.4.post1 — new providers, media support across channels, and major stability improvements. See release notes for details.
2026-02-20 🐦 Feishu now receives multimodal files from users. More reliable memory under the hood.
2026-02-19 ✨ Slack now sends files, Discord splits long messages, and subagents work in CLI mode.
2026-02-18 ⚡️ nanobot now supports VolcEngine, MCP custom auth headers, and Anthropic prompt caching.
2026-02-17 🎉 Released v0.1.4 — MCP support, progress streaming, new providers, and multiple channel improvements. Please see release notes for details.
2026-02-16 🦞 nanobot now integrates a ClawHub skill — search and install public agent skills.
2026-02-15 🔑 nanobot now supports OpenAI Codex provider with OAuth login support.
2026-02-14 🔌 nanobot now supports MCP! See MCP section for details.
2026-02-13 🎉 Released v0.1.3.post7 — includes security hardening and multiple improvements. Please upgrade to the latest version to address security issues. See release notes for more details.
2026-02-12 🧠 Redesigned memory system — Less code, more reliable. Join the discussion about it!
2026-02-11 ✨ Enhanced CLI experience and added MiniMax support!
2026-02-10 🎉 Released v0.1.3.post6 with improvements! Check the updates notes and our roadmap.
2026-02-09 💬 Added Slack, Email, and QQ support — nanobot now supports multiple chat platforms!
2026-02-08 🔧 Refactored Providers—adding a new LLM provider now takes just 2 simple steps! Check here.
2026-02-07 🚀 Released v0.1.3.post5 with Qwen support & several key improvements! Check here for details.
2026-02-06 ✨ Added Moonshot/Kimi provider, Discord integration, and enhanced security hardening!
2026-02-05 ✨ Added Feishu channel, DeepSeek provider, and enhanced scheduled tasks support!
2026-02-04 🚀 Released v0.1.3.post4 with multi-provider & Docker support! Check here for details.
2026-02-03 ⚡ Integrated vLLM for local LLM support and improved natural language task scheduling!
2026-02-02 🎉 nanobot officially launched! Welcome to try 🐈 nanobot!

</details>

🐈 nanobot is for educational, research, and technical exchange purposes only. It is unrelated to crypto and does not involve any official token or coin.

Key Features of nanobot:

🪶 Ultra-Lightweight: A super lightweight implementation of OpenClaw — 99% smaller, significantly faster.

🔬 Research-Ready: Clean, readable code that's easy to understand, modify, and extend for research.

⚡️ Lightning Fast: Minimal footprint means faster startup, lower resource usage, and quicker iterations.

💎 Easy-to-Use: One-click to deploy and you're ready to go.

🏗️ Architecture

News
Key Features
Architecture
Features
Install
Quick Start
Chat Apps
Agent Social Network
Configuration
[Multiple Instances](#-m

Nanobot

Install / Use

README

📢 News

Key Features of nanobot:

🏗️ Architecture

Table of Contents