项目分享|nanobot：超轻量级个人AI助手，4000行代码实现核心智能体能力

引言在AI智能体百花齐放的当下大而全的模型往往伴随着复杂的部署和高昂的资源消耗而HKUDS团队开源的nanobot却另辟蹊径以仅约4000行核心代码实现了工业级AI助手的核心能力体积较同类项目Clawdbot缩小99%兼具轻量、高效、易扩展的特性。这款基于MIT协议的超轻量级个人AI助手支持多平台对接、多LLM提供商兼容还能实现自动化任务调度成为开发者和个人用户的轻量智能选择。本文将从项目概况、核心优势与应用、技术部署与代码实践三方面全面解析nanobot的使用与价值。项目概况nanobot是由HKUDS团队开发的超轻量级开源个人AI助手灵感源自OpenClaw目前在GitHub收获28.7k stars、4.6k forks采用MIT开源协议代码以Python为主96.7%辅以少量TypeScript和Shell核心智能体代码仅3935行是目前轻量化AI助手中的代表性项目。项目自2026年2月正式发布后持续迭代当前最新版本为v0.1.4.post3完成了会话安全加固、上下文优化、多渠道兼容等多项升级现已支持OpenRouter、Anthropic、智谱、火山引擎等20主流LLM提供商可对接Telegram、飞书、钉钉、QQ、微信等10聊天平台还集成了MCP协议、vLLM本地模型支持、定时任务调度等核心功能。nanobot的核心定位是轻量可扩展的个人AI助手摒弃了冗余代码仅保留智能体核心的对话交互、工具调用、记忆管理能力同时提供极简的扩展接口开发者新增LLM提供商仅需2步操作个人用户可通过简单配置实现多场景智能交互兼顾研究与实际使用需求。核心优势与应用场景核心技术优势极致轻量资源消耗低核心智能体代码仅约4000行较同类项目缩小99%启动速度快、运行占用资源少可在普通电脑、轻量服务器甚至边缘设备上部署无需高性能算力支撑。多端兼容无缝对接支持Telegram、飞书、钉钉、QQ、WhatsApp、Slack等主流聊天平台部分平台采用WebSocket长连接模式无需公网IP即可实现消息互通还支持邮件协议可作为智能邮件助手。多LLM适配灵活切换兼容20主流LLM提供商既支持OpenRouter、Anthropic等海外平台也适配智谱、火山引擎、月之暗面等国内平台还支持vLLM本地模型部署支持自定义OpenAI兼容接口可按需选择算力方案。代码简洁易扩展易二次开发代码结构清晰、可读性强专为研究和二次开发设计新增LLM提供商、自定义技能仅需简单配置内置技能加载器和工具调用框架可快速集成自定义功能。功能完善兼顾实用性在轻量的基础上实现了智能体核心能力包括对话记忆、工具调用、定时任务、MCP协议集成、智能体社交网络对接等还支持语音转写、文件交互、跨平台消息同步等实用功能。部署简单上手门槛低提供PyPI、源码、uv三种安装方式支持Docker容器化部署和Linux系统服务化运行配置文件采用JSON格式关键参数有默认值个人用户2分钟即可完成初始化并实现聊天交互。典型应用场景个人智能助手对接微信、飞书、Telegram等常用社交软件实现日常对话、信息查询、任务提醒、邮件自动处理打造专属个人的AI助理。开发辅助工具兼容GitHub Copilot、OpenAI Codex等代码大模型可通过CLI或聊天平台实现代码生成、调试、技术问题解答提升开发效率。轻量自动化办公配置定时任务实现每日工作提醒、邮件扫描、数据统计对接办公软件实现文件处理、信息提取简化重复办公流程。AI智能体研究与实验代码结构简洁、轻量易修改适合开发者研究AI智能体的对话逻辑、工具调用、记忆管理机制快速验证新的智能体算法。小型团队协作助手部署在团队服务器上对接团队常用的Slack、飞书等平台实现团队任务调度、信息同步、协作提醒无需复杂的企业级AI系统。本地智能体部署支持vLLM本地大模型对接可在无网络环境下实现本地AI助手运行保障数据隐私适合对数据安全性有要求的个人和小型团队。技术原理与部署实践核心技术原理与架构nanobot采用模块化、松耦合的架构设计核心围绕「智能体逻辑多渠道对接多LLM适配」三大模块构建整体代码结构清晰各模块独立可扩展核心架构分为七层核心智能体层包含对话循环、上下文构建、记忆管理、技能加载、工具调用等核心逻辑是nanobot的大脑实现AI助手的核心交互能力技能层内置GitHub、天气、tmux等常用技能同时提供技能加载器支持自定义和第三方技能集成渠道层对接各聊天平台和邮件协议实现消息的接收与发送不同渠道采用统一的消息路由机制LLM提供商层适配各主流LLM平台的API提供统一的调用接口支持自动模型匹配和灵活切换任务调度层包含定时任务、心跳唤醒机制可实现周期性任务自动执行如每日提醒、邮件扫描配置层采用JSON格式的配置文件统一管理平台密钥、模型参数、权限控制等信息参数可灵活配置CLI层提供命令行交互接口支持初始化、聊天、网关启动、状态查询等核心操作方便快速使用和调试。nanobot的核心运行逻辑为「消息接收-上下文构建-LLM请求-结果处理-消息发送」通过轻量的上下文管理和记忆机制在保证对话连贯性的同时最大限度降低资源消耗工具调用和技能执行采用异步模式提升运行效率。环境搭建与安装nanobot支持源码安装、uv安装、PyPI安装三种方式适配Windows、Linux、MacOS系统推荐Linux系统用于部署核心安装命令如下# 方式1源码安装开发推荐含最新功能gitclone https://github.com/HKUDS/nanobot.gitcdnanobot pipinstall-e.# 方式2uv安装稳定、快速uv toolinstallnanobot-ai# 方式3PyPI安装稳定版个人用户推荐pipinstallnanobot-ai快速上手2分钟实现AI聊天nanobot提供极简的初始化和配置流程无需复杂操作即可实现核心聊天功能步骤如下1. 初始化配置与工作空间# 执行初始化自动生成配置文件和工作空间nanobot onboard执行后会在用户主目录生成~/.nanobot文件夹包含配置文件config.json和工作空间workspace。2. 配置LLM提供商以OpenRouter为例编辑~/.nanobot/config.json添加LLM提供商的API密钥和模型配置核心配置如下{providers:{openrouter:{apiKey:sk-or-v1-你的OpenRouterAPI密钥}},agents:{defaults:{model:anthropic/claude-opus-4-5,provider:openrouter}}}3. 启动CLI聊天模式# 交互式聊天直接与AI助手对话nanobot agent# 也可直接发送单条消息nanobot agent-m你好介绍一下你自己多平台对接以Telegram为例推荐nanobot支持对接主流聊天平台以Telegram为例仅需3步即可实现消息互通无需公网IP1. 获取Telegram机器人Token打开Telegram搜索BotFather发送/newbot按提示创建机器人复制生成的机器人Token格式123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11。2. 配置Telegram渠道编辑~/.nanobot/config.json添加Telegram配置{channels:{telegram:{enabled:true,token:你的Telegram机器人Token,allowFrom:[你的Telegram用户ID]}}}3. 启动网关实现消息互通# 启动网关nanobot将监听Telegram消息并自动回复nanobot gateway启动后在Telegram中向创建的机器人发送消息即可实现AI助手的自动回复。高级部署Docker容器化部署nanobot提供Docker Compose配置可快速实现容器化部署核心命令如下# 第一步初始化配置dockercompose run--rmnanobot-cli onboard# 第二步编辑配置文件添加API密钥、平台配置vim~/.nanobot/config.json# 第三步后台启动网关dockercompose up-dnanobot-gateway# 查看运行日志dockercompose logs-fnanobot-gateway# 停止容器dockercompose down关键配置与安全注意事项权限控制各渠道的allowFrom参数用于设置可交互的用户ID空列表默认允许所有用户生产环境建议指定具体用户ID保障使用安全本地模型部署支持vLLM本地模型只需启动vLLM服务并在配置文件中添加vLLM提供商信息即可实现本地大模型对接无需联网定时任务通过编辑~/.nanobot/workspace/HEARTBEAT.md文件可添加定时任务网关每30分钟会自动执行并将结果发送到最近活跃的聊天渠道MCP协议集成支持MCP协议可连接外部工具服务器将第三方工具作为nanobot的原生工具使用实现功能扩展。该项目及相关内容已AladdinEdu课题广场同步发布欢迎前往了解更多技术实现与资源项目地址AladdinEdu课题广场