Nanobot

Nanobot是什么?

Nanobot是HKUDS开发的超轻量级个人AI助手，受OpenClaw启发打造，核心代理代码仅约3827行，相比同类产品精简99%，又轻又小，部署简单、开发便捷，支持本地化部署和多端开发协同，极简代码编译成就了专业AI代理的全部核心能力，无需繁琐配置快速部署使用。

Nanobot主要功能

• 多场景AI助理核心能力：支持实时市场分析、全栈软件开发辅助、智能日常行程管理、个人知识管理与推理，覆盖工作、学习、生活多类需求。
• 多LLM模型兼容调用：可原生使用 OpenRouter 模型、Anthropic 模型、智谱 GLM 模型、月之暗面 Kimi 模型、通义千问模型等各种模型数十个 LLM 模型，还可配合 vLLM 部署模型到本地，支持自定义 OpenAI 兼容 API，新增模型商，开箱即用2步。
• 多平台聊天渠道联动：可对接telegram、飞书、QQ、钉钉、WhatsApp、Slack、email等主流聊天沟通工具，配置为各家平台聊天智能机器人，可以直接完成消息实时应答。
• 灵活的定时任务调度：支持按照Cron时间制定定时/定时任务，定时制定提醒、定时制定分析、定时制定指令等定时任务。
• 工具扩展与MCP协议支持：内置基础工具集，同时兼容 MCP（Model Context Protocol），可对接本地 / 远程工具服务器，将外部工具作为原生能力调用，实现功能无限拓展。
• 智能记忆与会话管理：双层架构记忆模式，充分记忆对话上下文、长期记忆保证AI连续理解能力，每个会话独立管理。
• 安全权限与沙箱控制：支持工作区沙箱控制，限制工具越权；每个聊天渠道可加用户白名单，指定用户才能与机器交互，安全性更高。
• Agent社交网络接入：一键接入Moltbook、ClawdChat等Agent的社交网络，能够将用户和别的AI代理沟通、拓展能力等。

适用场景

• 个人日常智能辅助：作为个人自己的智能助理，进行日程管理、知识查询、电子邮件自动回复、聊天工具统一响应等提升日常效率。
• 开发者研究与二次开发：代码结构清晰、可读性强，专为研究场景设计，对大模型进行应用、Agent能力、工具应用等研究及快速原型开发，或基于已有快速实现自定义个性化的AI助理。
• 本地AI代理私有化部署：支持基于vLLM进行本地大模型+AI代理的私有化部署，本地化部署不依赖外部服务，保证数据隐私、使用私有化，适合对数据隐私要求高的个人或小型团队。
• 小型团队协作辅助：部署为团队内部机器人，工作提醒、团队任务、团队协作问题解答，轻量化团队日常使用等。
• AI代理技术学习实践：超精简的核心代码降低了学习门槛，适合AI爱好者、AI开发的初学者学习AI代理核心技术点、代理模型打通、平台的联接等学习。 

Nanobot部署安装教程 

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

1. 前置环境准备

• 系统支持：Linux/macOS/Windows（Windows 建议用 WSL2）
• Python版本：≥3.10（建议使用 3.11 及以上），终端执行：python –version；看版本够不够，不够就升级
• 按需安装工具：Git（源码安装）、Docker/Docker Compose（容器化部署）、uv（轻量化包管理） 

2. 安装方式（任选其一）

• PyPI包安装（新手首选）：终端运行 pip install nanobot-ai（或 pip3 install nanobot-ai）
• uv工具安装（开发者推荐）：先运行 curl -LsSf https://astral.sh/uv/install.sh | sh 安装 uv 工具，再运行 uv tool install nanobot-ai
• 源码克隆安装（二次开发）：先运行 git clone https://github.com/HKUDS/nanobot.git 克隆代码到本地，进入目录然后 uv sync 或 pip install -e . 安装依赖
• Docker 容器化部署（服务器）：克隆完仓库，然后 cd 进仓库所在目录，执行 docker build -t nanobot . 或 docker compose up -d

3. 初始化配置

• 执行初始化命令：nanobot onboard
• 编辑配置文件（路径：~/.nanobot/config.json）：填入大模型 API 密钥、选择默认调用的大模型；可选填写聊天平台的 token、白名单用户等。

4. 启动与验证部署

• CLI模式（验证核心功能）：执行nanobot agent，输入测试指令（例如：“整理今日待办”），能有反应即操作成功
• 网关模式（多平台联动）：执行nanobot gateway，测试聊天平台的机器人是否反应正常
• 容器化验证：执行“docker ps | grep nanobot”查看容器状态，“docker exec -it nanobot nanobot agent”进入容器验证 

通过新媒派分享的以上简单的几个步骤，你就能快速掌握该工具的核心使用方法。