砍掉99%代码!港大开源Nanobot:4000行复刻OpenClaw核心功能

Nanobot 是香港大学数据科学实验室 HKUDS 开源的超轻量级个人 Agent,解决了 OpenClaw 代码臃肿、学习曲线陡峭的问题,可以看作是 OpenClaw 的极简版。

开源项目地址:https://github.com/HKUDS/nanobot。

Nanobot 将 OpenClaw 约 43 万行的代码压缩到了仅剩约 4000 行。对于想学习 AI Agent 原理的同学,Nanobot 简直是教科书级别的范本。

相比 OpenClaw,Nanobot 启动时间仅为 OpenClaw 的约十分之一,内存占用从 GB 级压缩到百 MB。

项目结构极其简单,很适合学习 agent 的基本原理。

nanobot/
├── agent/          # 🧠 Core agent logic
│   ├── loop.py     #    Agent loop (LLM ↔ tool execution)
│   ├── context.py  #    Prompt builder
│   ├── memory.py   #    Persistent memory
│   ├── skills.py   #    Skills loader
│   ├── subagent.py #    Background task execution
│   └── tools/      #    Built-in tools (incl. spawn)
├── skills/         # 🎯 Bundled skills (github, weather, tmux...)
├── channels/       # 📱 Chat channel integrations
├── bus/            # 🚌 Message routing
├── cron/           # ⏰ Scheduled tasks
├── heartbeat/      # 💓 Proactive wake-up
├── providers/      # 🤖 LLM providers (OpenRouter, etc.)
├── session/        # 💬 Conversation sessions
├── config/         # ⚙️ Configuration
└── cli/            # 🖥️ Commands

架构方面,Nanobot 使用 Agent Loop 循环,大模型调用与工具调用交替进行。支持 Memory、Skills 和 MCP,可以说是麻雀虽小五脏俱全。

nanobot-arch

安装方式

方式1:源码安装
git clone https://github.com/HKUDS/nanobot.git
cd nanobot
pip install -e .

方式2 PyPI
pip install nanobot-ai

方式3 uv
uv tool install nanobot-ai

执行 nanobot onboard 进行初始化,在 ~/.nanobot/config.json 中配置模型和 API key。

执行 nanobot agent 启动 Agent 命令行模式,如下图所示。进入交互模式则可以执行 nanobot。

nanobot-welcome

Nanobot 的记忆系统分为短期记忆和长期记忆,短期记忆是每天自动保存的 md 文件,长期记忆是系统自动保存的重要信息,存储在 ~/.nanobot/memory/ 目录。

Nanobot 内置了联网搜索、天气、github 等 Skills,用户也可以在 ~/.nanobot/skills/ 目录下自定义 Python 语言的 Skills。

Nanobot 原生支持多种大模型接入方式,如 openai 、deepseek、gemini、minimax、dashscope、zhipu 等。

Nanobot 支持接入 Telegram、Discord、WhatsApp、Mochat、钉钉、飞书、Slack、QQ 等 APP。官方推荐 Telegram,接入最简单。配置好 channel 后,仅需要执行 nanobot gateway 启动网关,就可以在 APP 里与 Agent 聊天了。

Nanobot 原生支持 MCP,只需要在 config.json 中配置 MCP Server。Nanobot 启动时会自动发现和注册 MCP tools,不需要额外的配置即可让大模型使用。

本站简介

聚焦于全栈技术和量化技术的技术博客,分享软件架构、前后端技术、量化技术、人工智能、大模型等相关文章总结。