nanobot：港大出品的超轻量级自托管个人AI智能体

Orca：并行运行 Claude Code、Codex 与 Cursor 的智能体开发环境（ADE） • herdr：为同时运行多个 AI 智能体打造的终端复用器

nanobot 是什么？ #

nanobot 是一个超轻量级、开源、自托管的Python个人AI智能体框架，出自 HKUDS——跟dibi8单独报道过的Vibe-Trading是同一个港大数据科学实验室。很多agent框架越做越重，nanobot反其道而行：核心代码小而可读，但工具、长期记忆、MCP、模型路由、多智能体委派、定时自动化和OpenAI兼容API一样都没少。

🔗 GitHub：https://github.com/HKUDS/nanobot 🌐 官网：https://nanobot.wiki

2026年2月首次推送，MIT协议，到2026年7月底已达到4.63万以上GitHub star。项目自己的选题研究发现了一个夸张的数据：GitHub trending页面一度只显示635星，而真实API核实的数字是数万级，低估了7134%——是它们研究过程中发现的最大差距。

它能做什么 #

• 以浏览器WebUI或终端形式运行
• 接入Telegram、Discord、Slack、微信、飞书、Teams、邮件和Mattermost
• 使用工具：文件、shell、网页搜索、网页抓取、MCP、定时任务、图像生成和子智能体
• 通过一个项目称为Dream的组件保留会话历史和长期记忆
• 执行长周期目标和定时自动化任务
• 暴露Python SDK和OpenAI兼容API方便自定义集成
• 作为长期运行的本地或服务端agent网关部署

安装 #

需要Python 3.11+。

一键安装(macOS/Linux)：

curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh

一键安装(Windows PowerShell)：

irm https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.ps1 | iex

会从PyPI安装/升级nanobot-ai，全新桌面安装还会启动nanobot webui，在Settings → Models里配置第一个provider。

其他安装方式：

uv tool install nanobot-ai

python -m pip install nanobot-ai

从源码安装(需要bun或npm来构建WebUI)：

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

快速开始 #

推荐的首次启动方式——打开浏览器工作台：

nanobot webui

然后：在Settings → Models选好provider/模型，发送Hello!验证连接，做正式项目工作前先选好工作区。

关闭终端后继续保持运行：

nanobot webui --background
nanobot gateway status
nanobot gateway logs

偏好网关优先的工作流(如果你是从OpenClaw过来会觉得熟悉)：

nanobot gateway

只在终端里工作，不开浏览器，不保留常驻渠道：

nanobot agent
nanobot agent -m "Hello!"   # 一次性，适合脚本调用

架构 #

nanobot围绕一个小的agent循环组织一切：消息从聊天app进来，LLM判断是否需要调用工具，记忆或技能只在需要时才作为上下文拉进来，而不是变成一层沉重的编排层。目的是让核心路径保持可读、易扩展，即使不断加渠道、加工具、加部署方式，系统也不会膨胀成一个庞然大物。

部署 #

一键Render部署直接写在仓库里(需要提供ANTHROPIC_API_KEY和一个私密的NANOBOT_WEB_TOKEN，然后配置持久化存储——注意持久化磁盘需要Render付费计划)。

自托管文档覆盖了Docker、Docker Compose、Linux服务和macOS LaunchAgent设置。

模型与Provider自由度 #

nanobot不绑定单一LLM厂商：广泛支持OpenAI兼容API，还专门文档了通过Ollama使用本地LLM，以及vLLM或其他本地OpenAI兼容服务器——意味着如果你想要，它可以完全离线跑在自托管模型上。

使用场景 #

1. 一个活在你聊天app里的个人智能体 #

接一次Telegram或微信，就能在手机上跟同一个有持久记忆的agent互动，不局限于桌面终端。

2. 不依赖重型平台的长期自动化 #

用nanobot gateway --background把定时任务和渠道连接当成轻量服务保持在线，不用采购一整套企业级agent平台。

3. 完全本地、自托管的智能体 #

搭配Ollama或本地vLLM服务器，打造一个数据完全不离开自有基础设施的个人agent。

4. 试验多智能体委派模式 #

用内置的子智能体工具试验委派模式，不用单独搭建编排基础设施。

相关仓库 #

相关文章 #

• Vibe-Trading：港大出品的开源市场研究智能体，不是交易机器人 —— 同一个实验室，完全不同的领域
• Orca：并行运行 Claude Code、Codex 与 Cursor 的智能体开发环境（ADE） —— 另一种个人AI基础设施思路，专门面向编码智能体

结语 #

nanobot 押注的是：个人AI智能体框架不需要做成重型平台才能有能力——小内核、自带WebUI、覆盖广泛的聊天app、完整自托管(包括完全本地模型)，就能覆盖很大一片场景，且不用背负大型agent平台那种运维负担。从一个被GitHub trending页面低估超过7000%的起点涨到4.6万+星，说明"小内核+自托管"这个定位一旦被人发现，是真的能打动人的。

最适合谁：想要一个完全自己掌控的个人AI智能体的开发者——自托管、聊天app可达、可选完全本地运行——又不想采用一个庞大、笨重的agent平台。

GitHub：https://github.com/HKUDS/nanobot

自建部署推荐基础设施 #

nanobot本身就是为自托管长期网关设计的：

• DigitalOcean —— 覆盖14个以上全球区域，60天200美元免费额度，很适合跑一个常驻的nanobot gateway实例。
• HTStack —— 香港VPS，从中国大陆访问延迟低，对微信/飞书这类聊天app集成尤其有用。这正是dibi8.com所在的机房。

以上为联盟链接——不会让你多花一分钱，但能帮助dibi8.com持续运营。

最后更新：2026-07-29

参考与来源 #

• nanobot
• nanobot.wiki
• Vibe-Trading
• Claude Code