nanobot是什么？
nanobot是由HKUDS开发的免费开源、自托管个人AI智能体框架，使用Python编写。 它不运行自己的语言模型 — 而是围绕你连接的模型包裹记忆、工具访问、多智能体协调和调度功能，并通过网页界面、终端或聊天应用集成将结果呈现出来。
- 产品类型：智能体框架／编排层，而非打包好的终端用户应用或模型
- 开发者：HKUDS（GitHub组织）
- 仓库：github.com/HKUDS/nanobot，创建于2026年2月1日
- 许可证：MIT，已通过GitHub仓库的许可证字段确认
- 文档：nanobot.wiki
- 截至本评测，根据GitHub API的规模数据：49,657星标、8,700次派生（fork比率约18%）、868个未关闭议题、207名订阅者、100多名贡献者，最新标记版本为v0.4.0（2026年10月28日）
nanobot实际能做什么？
nanobot在你已经能访问的模型之上叠加四项能力：持久记忆、MCP工具集成、多智能体委派和定时自动化。
- 持久记忆：根据nanobot.wiki，会话历史和长期记忆（文档中称为"Dream"）让智能体能够在多次对话间保留上下文，而不是每次会话都从零开始
- MCP工具集成：通过WebUI中的"Apps"界面连接Model Context Protocol（MCP）服务器，提供预设集成并支持添加自定义MCP服务器
- 多智能体委派：根据官方文档，nanobot可以把子任务委派给其他智能体，而不是在单一智能体循环中处理每一个步骤
- 定时自动化：智能体可以按计划运行，而不仅仅是响应实时聊天消息
- 模型路由：支持OpenAI兼容API、本地Ollama和本地vLLM后端，文档中还描述了备用模型路由功能
- 三种访问方式：基于浏览器的WebUI（通过
nanobot webui启动）、原生终端模式（通过nanobot启动），以及与Telegram、Discord、Slack、WhatsApp、微信、邮件、Mattermost、飞书、Microsoft Teams、Linear和QQ的集成
nanobot文档记载了什么（以及没有记载什么）
README记载了MCP、附件和聊天渠道，但没有提到提示缓存、WhatsApp或基准测试；仓库中的docs补充了WhatsApp、流式输出和心跳。 本节核对 github.com/HKUDS/nanobot 的README、同一仓库的docs文件夹（聊天应用参考和配置指南）以及 nanobot.wiki，覆盖搜索最多的功能，帮助你区分文档记载的行为与主观假设。
- 架构： README称，Python网关为WebUI、终端和聊天应用 "owns agent execution, sessions, tools, memory, and security policy"，核心智能体循环 "builds context, calls the model, executes requested tools, and returns the result"。它还写明 "Small core: readable internals with MCP, memory, deployment, and automation built in"。文中没有给出代码行数。
- MCP支持： 在WebUI中，"Apps" 可连接MCP服务器、启用Agent Plugins并管理本地CLI应用适配器；在终端中，
@可提及应用、MCP服务器或已保存的会话。文档中没有记载针对MCP的可靠性保证或测试结果。 - 提示缓存： README和配置指南均未提到
cache_control或Anthropic的提示缓存，也没有公布缓存命中数据。它们只说明：WebUI的上下文指示器会显示 "cache reuse when the provider reports it"；缓存命中 "still depend on the provider"；如果你的服务商保留提示缓存的时间更长，可以调大空闲压缩的超时时间。 - 流式输出： README没有明确提及，但聊天应用参考和配置指南有记载：Discord和飞书的回复默认以流式输出（
streaming默认为true，可以关闭），模型调用默认使用90秒的流空闲超时（NANOBOT_STREAM_IDLE_TIMEOUT_S）。 - 多模态与文件： WebUI支持 "Attach documents or images"，终端支持粘贴剪贴板图片（
Ctrl+V或Alt+V），工具列表中包含图像生成。v0.4.0的发布说明为WebUI新增了本地文件和视频附件、图片缩略图以及文件卡片。 - 聊天渠道： 仓库中的聊天应用参考涵盖Telegram、Discord、Slack、飞书、WhatsApp（通过二维码关联）、WhatsApp Agent Platform、微信、QQ、邮件、Mattermost和Linear等。README本身列出Telegram、Discord、Slack、微信、邮件、Mattermost和Linear以及 "other channels"，其 "Why nanobot" 列表另外提到飞书和Microsoft Teams。
- 心跳： 记载于配置指南，而非README。内置的心跳任务在
nanobot gateway下默认开启，每1,800秒（gateway.heartbeat.intervalS）检查一次HEARTBEAT.md，只把需要处理的结果发送到最近活跃的聊天。 - 可靠性： 文档描述了有序的备用模型链（
agents.defaults.fallbackModels）和消息发送重试（默认3次，间隔先1秒后2秒）。文档也写明了限制：网关重启后，错过的计划时间不会补跑，被中断的子智能体任务也不会自动重新启动。v0.4.0将对话历史迁移到SQLite。 - 基准测试： README和本评测读过的文档页面均未声称任何基准测试结果，本评测也没有进行过测试。
平台、价格与许可证
平台
- nanobot的官方说明:
- 根据GitHub仓库，可通过安装脚本自托管于Linux、macOS或Windows，或通过Docker／Docker Compose作为持久服务部署。
费用
- nanobot的官方说明:
- 免费开源。你只需为所连接的后端模型或API付费（如果运行本地Ollama或vLLM模型则无需付费）— 没有单独的付费nanobot版本。
许可证
- nanobot的官方说明:
- MIT许可证，已通过GitHub仓库的许可证字段确认。
硬件
- nanobot的官方说明:
- 本身没有GPU或最低内存要求 — 它是一个调用模型的智能体循环，而非推理引擎。实际硬件需求完全取决于你选择的后端模型。
安装方式
- nanobot的官方说明:
- 根据nanobot.wiki和GitHub README：macOS/Linux和Windows PowerShell各提供一行安装脚本，或通过
pip install nanobot-ai／uv tool install nanobot-ai安装。详见下方"安装nanobot"部分。
运行任何命令前，请直接在nanobot.wiki上核实当前的安装和部署说明，因为安装步骤可能随版本更新而变化。
安装nanobot
nanobot可通过一行脚本、包管理器或源码免费安装 — 没有付费版本或许可证密钥。
Install method | Command |
|---|---|
| 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 |
| 通过uv | uv tool install nanobot-ai |
| 通过pip | python -m pip install nanobot-ai |
| 从源码安装 | git clone github.com/HKUDS/nanobot，创建虚拟环境后运行pip install -e . |
| Docker / Docker Compose | GitHub仓库中记录了用于持久服务部署的方法 — 运行前请检查仓库中的最新compose文件。 |
| 官网与文档 | nanobot.wiki |
根据GitHub README，需要Python 3.11或更高版本；Git和Bun仅在从源码安装时需要。安装完成后，运行nanobot webui启动浏览器界面，或运行nanobot启动终端模式。
谁适合使用nanobot？
nanobot适合已经在运行或调用语言模型、并希望在其周围加入持久记忆、工具访问和自动化功能的人，而不是寻找一款打包好的全能助手应用的人。
以下情况请使用nanobot
- 你已经能访问OpenAI兼容API，或通过Ollama或vLLM运行本地模型，并希望在其之上加一层智能体，而不是搭建完整的推理栈
- 你希望智能体能记住过去的会话，而不是每次对话都从零开始
- 你需要连接MCP工具服务器，让智能体能对外部系统采取行动，而不只是回答问题
- 你希望通过浏览器、终端和Telegram或Slack等聊天应用访问同一个智能体，而不局限于单一界面
- 你能够接受自托管一个Python服务，而不是寻找托管、托管管理的产品
以下情况请考虑其他方案
- 你想要一款无需配置、可直接下载的单一桌面应用 — nanobot是自托管框架，不是成品的一键安装程序
- 你需要有厂商支持、附带支持合同和SLA的产品 — 本评测未发现nanobot背后有融资轮次或商业公司
- 你不习惯运行安装脚本、pip包或Docker容器
- 你想要经独立审计的长期使用记录 — 截至本评测，nanobot的仓库大约只有九个月历史
nanobot不适合什么场景
如果你想要一款成品、打包好的助手应用，或者在采用工具前需要经独立验证的长期使用记录，nanobot并不合适。
- 不是推理引擎 — 它本身没有GPU/显存要求，但它自身也不执行模型推理；实际进行推理的模型仍需要Ollama、vLLM或API密钥
- 不是精心打磨的一体化桌面应用 — 它是一个需要你自行配置的自托管框架，配置成本更接近CrewAI或agent-zero，而不是一键式聊天应用
- 本评测未能核实其背后有融资轮次或公司支持 — 请将其视为一个独立维护、由社区驱动的项目
- 上文提到的星标数注意事项同样适用 — 本评测在GitHub其他地方发现了使用完全相同营销文案的仿冒仓库，因此在信任任何标注为"nanobot"的星标数之前，请确认你查看的确实是github.com/HKUDS/nanobot
- 不是历史悠久的项目 — 该仓库创建于2026年2月1日，因此不具备AutoGPT或Open Interpreter等框架那样多年的使用记录
评估nanobot时的常见误区
关于nanobot的大部分误解，源于将其与一个无关的同名项目混淆，或误读其增长数字。
误区一：与nanobot-ai/nanobot混淆
一个独立、无关的GitHub项目——nanobot-ai/nanobot，由Obot团队描述为"构建MCP智能体"，创建于2025年5月16日左右，约有1,343星——与它同名。本评测仅涉及HKUDS/nanobot；安装任何一个之前，请核对GitHub URL中的组织名称。
误区二：把星标数当作经审计的增长信号
一个2026年2月创建的仓库拥有49,657星标，增速异常快，而GitHub搜索会发现使用相同营销描述的仿冒仓库。8,700次派生、868个未关闭议题和100多名贡献者的数字暗示主要为有机活动，但本评测并未独立审计其星标历史 — 请直接在GitHub上核实当前数字，而不要把本评测的快照数据当作最新信息引用。
误区三：期望nanobot自己运行模型
nanobot仅需CPU，因为它不执行推理 — 它调用的是OpenAI兼容API、本地Ollama服务器或本地vLLM服务器。你的硬件需求取决于所选的后端模型，而不是nanobot本身。
误区四：以为存在付费版本
nanobot在MIT许可证下免费开源，没有单独的付费版本。任何费用都来自你所连接的后端模型或API。
竞品与替代方案
nanobot最常与AutoGPT、Open Interpreter、agent-zero和CrewAI等其他自托管智能体框架相比较 — 它的主要差异化在于将持久记忆、MCP工具、多智能体委派和聊天应用集成整合在一个框架内，而不是只专精其中一项。
Tool | Best known for | Link |
|---|---|---|
| AutoGPT | 最早的自主智能体框架之一，专注于目标驱动的任务链 | AutoGPT评测 |
| Open Interpreter | 让模型在本地执行代码以完成任务，因简单易用而流行 | Open Interpreter评测 |
| agent-zero | 基于Docker的自托管通用智能体框架，具备持久化环境 | agent-zero评测 |
| CrewAI | 专注于基于角色的智能体团队的多智能体编排框架 | CrewAI评测 |
此列表反映的是在同一自托管智能体框架领域中常与nanobot比较的工具，而非PromptQuorum的独立排名 — 选择前请核实每款工具当前的功能集。
常见问题
nanobot是什么？
nanobot（nanobot.wiki）是HKUDS开发的免费开源（MIT）自托管个人AI智能体框架，为你连接的模型增加持久记忆、MCP工具集成、多智能体委派和定时自动化功能。
nanobot免费吗？
是的，nanobot本身在MIT许可证下免费开源，没有单独的付费版本。你只需为所连接的后端模型或API付费。
如何安装nanobot？
根据nanobot.wiki和GitHub README：为macOS/Linux或Windows PowerShell运行一行安装脚本，或通过pip install nanobot-ai或uv tool install nanobot-ai安装。需要Python 3.11或更高版本。
nanobot自己运行AI模型吗？
不。nanobot是一个智能体框架，而非推理引擎 — 它调用的是OpenAI兼容API、本地Ollama服务器或本地vLLM服务器。它本身没有GPU要求；硬件需求取决于你选择的后端模型。
nanobot能与哪些聊天应用集成？
根据仓库中的聊天应用参考：包括Telegram、Discord、Slack、飞书、WhatsApp、微信、QQ、邮件、Mattermost和Linear等。README还列出了Microsoft Teams，此外还有自带的网页界面和终端模式。
nanobot和nanobot-ai/nanobot是同一个项目吗？
不是。nanobot-ai/nanobot是Obot团队开发的一个独立、无关、规模更小的"构建MCP智能体"项目（约1,343星，创建于2025年5月16日）。本评测仅涉及HKUDS/nanobot — 安装前请核对GitHub组织名称。
为什么一个这么新的项目，nanobot的GitHub星标数会这么多？
一个创建于2026年2月1日的仓库拥有49,657星标，增速异常快，而GitHub搜索会发现使用完全相同营销文案的仿冒仓库。约18%的fork比率、数百个未关闭议题和100多名贡献者暗示主要为有机活动，但本评测并未独立审计其星标历史 — 请直接在GitHub上核实当前数字。
什么是MCP？nanobot如何使用它？
MCP（Model Context Protocol）是一种标准，让AI智能体能够通过专用服务器连接外部工具和数据源。nanobot通过WebUI中的"Apps"界面连接MCP服务器，提供预设集成并支持自定义服务器。
nanobot支持多智能体工作流吗？
是的。根据官方文档，它可以把子任务委派给其他智能体，而不是在单一智能体循环中处理每一个步骤。
PromptQuorum是否独立测试过nanobot的说法？
本评测基于nanobot的GitHub README、nanobot.wiki文档和GitHub API，而非PromptQuorum对记忆能力或多智能体性能的实际测试。
nanobot支持提示缓存（prompt caching）吗？
没有作为已记载的功能。README和配置指南都没有提到 cache_control 或Anthropic的提示缓存。仅有的相关内容是WebUI上下文指示器中的 "cache reuse when the provider reports it"，以及一条说明：缓存命中 "still depend on the provider"。在假定缓存已生效之前，请先查阅你的模型服务商文档。
nanobot支持WhatsApp吗？
支持，依据仓库中的聊天应用参考：有一个通过扫描二维码关联的WhatsApp渠道（nanobot channels login whatsapp），以及另一个使用智能体API令牌的WhatsApp Agent Platform渠道。README没有提到WhatsApp，因此请查阅你所安装版本的文档。
nanobot是否支持流式输出回复？
部分支持，依据聊天应用参考和配置指南，而非README。Discord和飞书的回复默认以流式输出（streaming 默认为 true），模型调用使用90秒的流空闲超时（NANOBOT_STREAM_IDLE_TIMEOUT_S）。本评测读过的页面没有说明其他渠道是否都逐token流式输出。
nanobot支持图片和文件（多模态）吗？
部分有文档记载。WebUI支持附加文档或图片，终端支持粘贴剪贴板图片，工具列表包含图像生成。实际能使用哪些图片输入取决于你连接的后端模型，因为nanobot本身不执行推理。
nanobot的架构是怎样的？
根据其README，一个Python网关负责智能体执行、会话、工具、记忆和安全策略，WebUI、终端和聊天应用都是同一运行时的客户端。核心智能体循环会构建上下文、调用模型、执行所请求的工具并返回结果。nanobot本身不运行模型：它调用兼容OpenAI的API、本地Ollama服务器或本地vLLM服务器。
nanobot有基准测试吗？
nanobot的README没有声称任何基准测试，PromptQuorum也没有运行过任何测试。请将其他地方引用的nanobot性能数字视为未经验证。