A curated collection of resources, tools, skills, and projects for nanobot - the ultra-lightweight AI assistant framework.
Official Repo • Resources • Skills • Community
简体中文 | English
Note: This list focuses on HKUDS/nanobot (Python). There's another project with a similar name on GitHub - please make sure you're using the correct repository.
- Official Resources
- Quick Start
- LLM Providers
- Chat Channels
- MCP Support
- Deployment
- Skills & Plugins
- Ecosystem Projects
- Desktop & GUI
- Language Ports
- Tutorials
- Security
- Community
- Contributing
| Resource | Description |
|---|---|
| GitHub Repository | Official nanobot repository |
| Releases | Changelog and version history |
| Security Policy | Security guidelines for production |
| User Profile Template | Personalization configuration |
| nanobot.wiki | Official website (Multi-language docs) |
| nanobot.club | Community website |
| Method | Command |
|---|---|
| uv (Recommended) | uv tool install nanobot-ai |
| PyPI | pip install nanobot-ai |
| From Source | git clone https://github.com/HKUDS/nanobot.git && cd nanobot && pip install -e . |
Basic Commands:
nanobot onboard # Initialize configuration
nanobot agent # Start CLI conversation
nanobot gateway # Start gateway for chat channels📁 Detailed Tutorial: docs/TUTORIAL.md | 中文教程
nanobot supports multiple LLM providers:
| Provider | Type | Notes |
|---|---|---|
| OpenRouter | API | Multiple models via single API |
| Anthropic | API | Claude models |
| OpenAI | API | GPT models |
| DeepSeek | API | DeepSeek models |
| Gemini | API | Google Gemini |
| Qwen / DashScope | API | Alibaba models |
| Moonshot | API | Kimi models |
| Groq | API | Fast inference |
| Custom Endpoint | API | OpenAI-compatible APIs |
| GitHub Copilot | OAuth | Via OAuth |
| OpenAI Codex | OAuth | Via OAuth |
📖 Provider Configuration: Official README - Providers
| Channel | Status | Notes |
|---|---|---|
| Telegram | ✅ Stable | Recommended for beginners |
| Discord | ✅ Stable | Full support |
| Feishu (飞书) | ✅ Stable | Chinese enterprise IM |
| DingTalk (钉钉) | ✅ Stable | Chinese enterprise IM |
| ✅ Stable | Requires Node.js bridge | |
| Slack | ✅ Stable | Enterprise chat |
| ✅ Stable | IMAP/SMTP | |
| ✅ Stable | Via go-cqhttp | |
| MoChat | ✅ Stable | Claw IM |
📖 Channel Setup: Official README - Chat Apps
nanobot supports Model Context Protocol (MCP) for extending capabilities:
| Transport | Description |
|---|---|
| stdio | Local MCP servers via standard I/O |
| HTTP | Remote MCP servers via HTTP |
| SSE | Server-Sent Events for real-time streaming |
📖 MCP Configuration: Official README - MCP
| Method | Description |
|---|---|
| Docker | Official Docker support |
| Docker Compose | One-click deployment |
| Zeabur Template | One-click cloud deployment |
| Render Template | One-click Render deploy template |
| Project | Stars | Description |
|---|---|---|
| nanobot-llm-wiki | ⭐ 1 | LLM Wiki long-term memory plugin for NanoBot |
| Skill | Description | Status |
|---|---|---|
| memory | Long-term memory system | Built-in |
| cron | Scheduled tasks | Built-in |
| weather | Weather forecasts | Built-in |
| clawhub | Skill registry search | Built-in |
| skill-creator | Create custom skills | Built-in |
| Skill | Author | Description |
|---|---|---|
| jina-search-skill | billLiao | Jina.ai web search and page reading |
| bark-push-skills | billLiao | iOS push notifications |
| nanobot-skills | ruslanstarikov | Custom skills collection |
| nanobot-skills | CCAgentOrg | github-watcher, youtube-recommender |
| nanobot-skill-weather | kombalarasoftware | Weather skill |
| nanobot-skill-finance | kombalarasoftware | Financial data skill |
| nanobot-skill-notes | kombalarasoftware | Notes management |
| nanobot-skill-calendar | kombalarasoftware | Calendar integration |
| nanobot-skill-translator | kombalarasoftware | Translation skill |
| Platform | Description |
|---|---|
| ClawHub | Official skill registry for discovering and installing skills |
| Project | Stars | Description |
|---|---|---|
| nanobot | ⭐ 1.3k | Build MCP Agents — Official nanobot with enhanced MCP support |
| NanoResearch | ⭐ 1.5k | 🦞+🔬 Autonomous AI Research Assistant powered by nanobot |
| TinyClaw | ⭐ 280 | The original Tiny Claw as your personal autonomous AI companion |
| OpenLegion | ⭐ 105 | Secure autonomous AI agent fleet platform — Docker-isolated, multi-provider |
| MultiUserClaw | ⭐ 305 | Multi-user support for OpenClaw/NanoBot |
| NanoBot | ⭐ 61 | ZeroBot-style QQ channel/group bot framework |
| FastSkills | ⭐ 15 | MCP server that brings Agent Skills to any MCP-compatible agent |
| nanobot-custom | ⭐ 65 | Personal AI assistant based on nanobot — supports MiniMax, Gemini multi-model switching |
| MoChat | - | Claw IM client, nanobot channel support |
| ClawWork | - | OpenClaw/Nanobot integration |
| SwarmClaw | ⭐ 633 | Multi-agent swarm coordination |
| Ferrum Bot | ⭐ 23 | Rust-based AI agent framework |
| GeneClaw | ⭐ 41 | Self-evolving AI agent framework with 5-layer safety gateway |
| TinyBot | ⭐ 3 | Lightweight agent framework based on nanobot |
| nanobot-web-console | ⭐ 13 | Single-file Web console with real-time streaming chat |
| nanobot-setup | ⭐ 2 | Automated installation script (Docker + Redis + Qdrant) |
| NanoBot-Android | ⭐ 35 | Personal AI assistant for Android — nanobot-inspired |
| OSA | ⭐ 40 | Optimal System Agent — maximizes signal extraction |
| ByeByeClaw | ⭐ 74 | One command to uninstall ALL Claw-family AI agents. Zero residual files |
| NanoClaw | ⭐ 30k | Lightweight alternative to OpenClaw — runs in containers, connects to WhatsApp, Telegram, Slack, Discord, Gmail |
| nanobot-study | ⭐ 15 | Master AI Agent Assistant in 3 Days — guided study plan |
| nanobot-rs | ⭐ 6 | AI Agent Platform built in Rust — Multi-model, MCP tools |
| nanobot-viking | ⭐ 10 | OpenViking knowledge base integration — RAG, semantic search, vector embeddings |
| nanobot-teams | ⭐ 0 | Manage multiple AI agent teams collaborating in isolated workspaces |
| nanobot-feishu-specialized | ⭐ 67 | Feishu-specific version with enhanced features |
| LemonClaw | ⭐ 1 | AI Agent Platform (MIT, fork of nanobot) |
| nanobot-docker | ⭐ 6 | Dockerized setup for nanobot |
| nanobot-webgui | ⭐ 21 | Production-focused web GUI fork with setup wizard, MCP management, chat, memory, and admin controls |
| nanobot-webui | ⭐ 150 | A self-hosted web management panel for nanobot-ai |
| nanobot-task-pipeline | ⭐ 14 | Automated task pipeline powered by nanobot & Claude Code — multi-stage workflow with heartbeat scheduler |
| nanobot-searxng-search | ⭐ 4 | SearXNG search skill for Nanobot — self-hosted search integration |
| nanobot-a2a-proxy | ⭐ 1 | A2A Proxy for nanobot agent communication |
| nanobot-ts | ⭐ 13 | TypeScript version of nanobot — ultra-lightweight personal AI assistant framework |
| nanobot-hass | ⭐ 1 | Home Assistant custom component for nanobot conversation agent |
| nanobot-on-rpi | ⭐ 0 | Recipe for running nanobot on Raspberry Pi |
| NanoMate | ⭐ 87 | nanobot × SillyTavern, with Companion Mode |
| ShibaClaw | ⭐ 79 | Self-hosted AI assistant framework — Multi-channel (Telegram, Discord, Slack), parallel agents, MCP support, WebUI with OAuth |
| Project | Stars | Description |
|---|---|---|
| nanoBot-ui | ⭐ 174 | Plug-and-play nanobot for Windows 10+ |
| nanobot-desktop | ⭐ 49 | Tauri + React desktop client |
| nanobot-webui | ⭐ 32 | Web UI with visual configuration & knowledge management |
| Project | Stars | Description |
|---|---|---|
| NanoBot.net | ⭐ 11 | .NET 10 port |
| nanobot-rs | ⭐ 7 | Rust port |
| sharpclaw | ⭐ 25 | AI agent with long-term memory (.NET 10) |
| maxclaw | ⭐ 229 | Ultra-Lightweight AI Assistant in Go |
| agent-diva | ⭐ 59 | Next Gen AI Agent (nanobot-rs-pro, Rust) |
| MetalClaw | ⭐ 3 | Personalized AI assistant fork |
| ha-nanobot | ⭐ 1 | Home Assistant integration (Shell) |
| nano-claw | ⭐ 67 | 🦞 Claw is a personal AI assistant you run on your own devices, but nano (TypeScript) |
| nanobot-golang | ⭐ 0 | Lightweight, data-driven AI assistant framework in Go. 18+ LLM providers, 9 chat channels, MCP tools |
| nanobot-go | ⭐ 6 | Go implementation of nanobot |
| mini_nanobot | ⭐ 10 | Lightweight LLM Agent framework for learning |
| PP-Claw | ⭐ 36 | Go version of nanobot |
| Project | Stars | Description |
|---|---|---|
| NanoBot-Plugin | ⭐ 106 | QQ bot plugin collection |
| Resource | Language | Type |
|---|---|---|
| Tutorial (EN) | English | Complete guide |
| 教程 (中文) | 中文 | 完整教程 |
| DataCamp Tutorial | English | Third-party tutorial |
| YouTube Demo | English | Ollama + Telegram setup |
| Medium Architecture | English | Architecture deep-dive |
| nanobot-learn | 中文 | Learn Nanobot Design Principles in 7 Days |
| byte-of-nanobot | 中文 | 面向零基础用户的 nanobot 教程，从"能跑"到"懂原理" |
| agent-tutor | 中文 | 从 0 到 1 搭建生产级 AI Agent 实战教程 |
| how-ai-agents-remember | 中/EN | 源码级逆向工程 nanobot 等 Agent 记忆系统 — 架构图、数据模型、检索管线 |
⚠️ Important: Read the Security Policy before production deployment.
Key Security Practices:
| Practice | Description |
|---|---|
| API Key Management | Never commit to repo; set chmod 600 ~/.nanobot/config.json |
| Channel Access Control | Configure allowFrom whitelist in production |
| Workspace Restriction | Set tools.restrictToWorkspace=true |
| Command Execution | Run with restricted user; enable audit logs |
| Dependency Security | Run pip-audit / npm audit regularly |
| Platform | Link |
|---|---|
| GitHub Discussions | github.com/HKUDS/nanobot/discussions |
| Discord | discord.gg/MnCvHqpUGB |
| WeChat / Feishu | See COMMUNICATION.md |
Contributions are welcome! Please read the Contributing Guidelines before submitting a PR.
Guidelines:
- Only add verifiable links
- Include a brief description for each resource
- Mark third-party content clearly
- Check link availability regularly
To the extent possible under law, the contributors have waived all copyright and related rights to this work.