nanobot 使用教程

45K Star 港大开源 · 能自己拥有的轻量 AI Agent

⭐ 开源免费 · MIT 协议

📖 项目简介

nanobot 是香港大学数据智能实验室(HKUDS)开源的一款 超轻量个人 AI Agent,GitHub 上已经拿下约 45K Star。 它主打「核心小而可读、却五脏俱全」:把 Agent 内核做得干净精简,同时把真正干活需要的部件都备齐—— WebUI、聊天入口、工具调用、长期记忆、MCP、模型路由、自动化与部署一应俱全。

和又重又难跑的大而全 Agent 不同,nanobot 一条命令就能跑起来,自己部署、自己拥有, 非常适合想要一个「真正属于自己」的私人 AI 助手的人。

核心亮点

🪶
极致轻量
核心小而可读,一条命令跑起来,部署省心
💬
多聊天入口
支持微信、邮件等,直接在聊天窗口发指令
🧠
长期记忆 Dream
记住你的偏好和历史,越用越懂你
🧩
工具 & MCP
文件/命令行/联网/生图/子代理 + MCP + OpenAI 兼容 API

🚀 如何使用

1

安装 nanobot

在 GitHub 搜索 HKUDS/nanobot 进入项目主页,按官方文档安装。 官方提供了「零技术背景」引导,也支持 pip 快速安装或运行一键安装脚本, 安装完成后即可在终端得到一条 CLI 回复。

2

配置大模型

在配置文件里填入大模型的 Provider 和 API Key,nanobot 支持配置 备用模型(fallback)与模型路由,还能接入 MCP、联网工具等。 配置一次,之后就能稳定跑起来。

3

发指令 & 挂自动化

打开自带的 WebUI,或把它接进微信,直接在聊天窗口发一句话让它干活—— 联网查资料、执行命令、生成图片都行。还能设定 定时任务,让它挂在后台自动跑长任务,全程不用你盯着。

常见问题

Q: 它和那些大而全的 Agent 有什么区别?

定位类似,但 nanobot 主打轻量——核心代码干净可读、体积小、部署省心,一条命令就能跑起来,很适合想自己拥有、自己折腾的人。

Q: 需要付费吗?

nanobot 本身完全开源免费(MIT 协议),自己部署即可。只是调用大模型时的 API 费用需要你自备对应的模型账号。

Q: 支持哪些大模型?

支持主流大模型 Provider,可以配置备用模型和模型路由,并提供 OpenAI 兼容接口与 Python SDK,方便接进你自己的系统。