Nanobot 🐱 — Python based alternative to OpenClaw / PicoClaw / ZeroClaw / AgentZero

[robi]

nanobot: Ultra-Lightweight Personal AI Assistant

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

️ Delivers core agent functionality in just ~4,000 lines of code — 99% smaller than Clawdbot's 430k+ lines.

Real-time line count: 3,932 lines (run bash core_agent_lines.sh to verify anytime)

News

• 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!

Earlier news

• 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!

Key Features of nanobot:

🪶 Ultra-Lightweight: Just ~4,000 lines of core agent code — 99% smaller than Clawdbot.

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

Features

24/7 Real-Time Market Analysis	Full-Stack Software Engineer	Smart Daily Routine Manager	Personal Knowledge Assistant
Discovery • Insights • Trends	Develop • Deploy • Scale	Schedule • Automate • Organize	Learn • Memory • Reasoning

Install

Install from source (latest features, recommended for development)

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

Install with uv (stable, fast)

uv tool install nanobot-ai

Install from PyPI (stable)

pip install nanobot-ai

Quick Start

Tip

Set your API key in ~/.nanobot/config.json. Get API keys: OpenRouter (Global) · Brave Search (optional, for web search)

1. Initialize

nanobot onboard

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

Add or merge these two parts into your config (other options have defaults).

Set your API key (e.g. OpenRouter, recommended for global users):

{
"providers": {
"openrouter": {
"apiKey": "sk-or-v1-xxx"
}
}
}

Set your model (optionally pin a provider — defaults to auto-detection):

{
"agents": {
"defaults": {
"model": "anthropic/claude-opus-4-5",
"provider": "openrouter"
}
}
}

3. Chat

nanobot agent

That's it! You have a working AI assistant in 2 minutes.

[timconsidine]

Packaged Nanobot for Cloudron
So far I like more than Picoclaw, but I don't have much evidence to support that. Just a feeling.

git : https://git.cloudron.io/timconsidine/cloudron-nanobot.git

docker image : tcmbp132021/cloudron-nanobot:v0.0.1

[robi]

@timconsidine manifest missing for CCAI-P to install

[timconsidine]

@robi oooops, sorry
There now

v0.0.9

I tried my self-hosted Ollama models and they work.
However I found skills work better with openai and gpt-4o.
Trying to identify an ollama cloud model (my preference) which will work with skills and not require patching.