HKUDS/nanobot

Lightweight, open-source AI agent for your tools, chats, and workflows.

43.5k stars | 作者：港大数据科学与工程系（HKUDS） | 当前版本：v0.2.1

极简、可读内核的开源 AI Agent 运行时，主打”拥有自己的 Agent 技术栈”。围绕一个小型 Agent 循环构建，支持长时任务、多渠道接入、Memory、MCP、模型路由、WebUI 和部署。

核心定位

超轻量：可读的小型内核，核心路径简单，易于扩展
持久化工作流：目标（/goal）、记忆、工具和上下文在长时运行中持续存活
Chat-native：WebUI、API、Telegram、飞书、Slack、Discord、Teams、Email 等
模型自由：OpenAI 兼容 API、本地 LLM、图像生成、Web 搜索、Fallback 备用模型
自托管：可检查、可定制、不依赖大型平台

安装

# PyPI
pip install nanobot-ai
 
# uv（推荐）
uv tool install nanobot-ai
 
# 源码（最新特性）
git clone https://github.com/HKUDS/nanobot.git && pip install -e .

快速开始

nanobot onboard        # 初始化交互式向导
nanobot agent          # 启动 CLI 对话
nanobot gateway        # 启动 WebUI + 渠道网关（访问 http://127.0.0.1:8765）

配置文件：~/.nanobot/config.json，支持 OpenRouter、OpenAI、Anthropic、本地 LLM 等。

架构

以 小型 Agent 循环 为核心：消息从聊天应用进入 → LLM 决定何时调用工具 → Memory/Skills 作为上下文按需注入（而非重型编排层）。保持核心路径可读，支持按需叠加渠道、工具、Memory、部署选项。

Chat Apps ──→ Gateway ──→ Agent Loop ──→ LLM
                              ↑↓
                    Tools / Memory / Skills / MCP

主要功能

能力	说明
WebUI	内嵌在 wheel 包中，无需单独构建，支持 Thought/Response 时间线、项目工作区
`/goal` 持续目标	跨对话轮次保持长期目标，可见多步进度
Memory	Dream 两阶段记忆系统，Token 级压缩
MCP	多 MCP 服务器、资源/提示词暴露为工具、CLI Apps 扩展
渠道（Channels）	Telegram、飞书、Slack、Discord、Teams、Email、WeChat、QQ、Signal、Matrix 等
模型路由	`fallback_models`、provider 自动检测、模型预设保存
定时任务	Cron 调度、自然语言提醒
部署	Docker、Linux 服务、macOS LaunchAgent
OpenAI 兼容 API	兼容 OpenAI API 接口，支持 SSE 流式
Python SDK	可编程接入

支持的 Provider（部分）

OpenAI、Anthropic、DeepSeek、Gemini、OpenRouter、Ollama、vLLM、LM Studio、Azure OpenAI、AWS Bedrock、VolcEngine、MiniMax、Moonshot/Kimi、NVIDIA NIM、Atomic Chat（本地）等

版本历程

版本	时间	核心特性
v0.2.1	2026-06-01	Workbench Release：清晰的 Thought/Response 时间线、实时文件编辑活动、项目工作区、CLI Apps + MCP 扩展
v0.2.0	2026-05-15	`/goal` 持续目标、WebUI 内嵌 wheel、图像生成端到端、5 个新 Provider、Agent 循环重构
v0.1.5	2026-04-05	长时任务加固、Dream 两阶段记忆、生产级沙箱、编程 Agent SDK
v0.1.4	2026-02-17	MCP 支持、流式进度、多 Provider
v0.1.3	早期	多平台渠道（Slack/Email/QQ/Discord/Feishu）、DeepSeek/Qwen 等

与同类工具对比

vs OpenClaw：nanobot 更通用，支持多 IM 渠道接入；OpenClaw 专注 AI coding agent 编排
vs hermes-agent：定位相似（轻量 Agent Runtime），nanobot 渠道更丰富、文档更完善
vs botmux：botmux 是飞书 + CLI 桥接层（非 SDK wrapper）；nanobot 是完整 Agent 运行时

zhaoweiguo 的知识库

目录