5步搞定！nanobot超轻量AI助手部署与使用教程
5步搞定！nanobot超轻量AI助手部署与使用教程
1. nanobot简介：为什么选择这个超轻量AI助手
nanobot是一款受OpenClaw启发的超轻量级个人人工智能助手，它的最大特点就是极其精简高效。相比其他动辄数十万行代码的AI助手，nanobot仅需约4000行代码就能提供核心代理功能，代码量减少了99%！
这意味着什么？意味着更快的部署速度、更低的资源消耗、更简单的维护成本。无论你是想快速搭建一个个人AI助手，还是需要在资源有限的环境中部署AI能力，nanobot都是一个绝佳的选择。
当前版本内置了基于vllm部署的Qwen3-4B-Instruct-2507模型，使用chainlit进行推理交互，还支持自行配置QQ聊天机器人等多种扩展功能。
2. 环境准备与快速部署
2.1 系统要求与前置准备
在开始部署之前，请确保你的系统满足以下基本要求：
- Linux系统（推荐Ubuntu 18.04+或CentOS 7+）
- Docker已安装并正常运行
- 至少8GB可用内存
- 20GB可用磁盘空间
- 网络连接正常
如果你还没有安装Docker，可以使用以下命令快速安装：
# Ubuntu/Debian系统 curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh # CentOS/RHEL系统 sudo yum install -y yum-utils sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo sudo yum install docker-ce docker-ce-cli containerd.io2.2 一键部署nanobot
部署nanobot非常简单，只需要几个命令就能完成：
# 克隆nanobot仓库 git clone https://github.com/HKUDS/nanobot.git # 进入项目目录 cd nanobot # 构建Docker镜像 docker build -t nanobot .这个过程可能会花费一些时间，因为需要下载和构建相关的依赖项。构建完成后，你就拥有了一个完整的nanobot环境。
3. 基础功能使用与测试
3.1 验证模型部署状态
部署完成后，首先需要确认模型服务是否正常运行：
# 查看模型服务日志 cat /root/workspace/llm.log如果看到类似下面的输出，说明模型部署成功：
模型服务启动成功 vllm引擎已初始化 Qwen3-4B-Instruct-2507模型加载完成3.2 使用chainlit进行对话测试
nanobot提供了基于chainlit的Web界面，让交互变得更加直观：
# 启动chainlit界面（如果尚未自动启动） chainlit run app.py启动后，在浏览器中访问提示的地址（通常是http://localhost:8000），你就可以看到一个简洁的聊天界面。
3.3 进行首次对话测试
在chainlit界面中，尝试输入一些测试问题：
你好，请介绍一下你自己或者测试一些实用功能：
使用nvidia-smi看一下显卡配置系统会调用相应的工具来执行你的指令并返回结果。第一次使用可能会稍微慢一些，因为需要加载模型和初始化环境。
4. 高级功能：接入QQ机器人
4.1 注册QQ开放平台账号
要将nanobot接入QQ机器人，首先需要注册QQ开放平台账号：
- 访问QQ开放平台：https://q.qq.com/#/apps
- 注册个人或企业开发者账号（个人开发者即可）
- 完成实名认证和相关资料填写
4.2 创建QQ机器人应用
注册完成后，按照以下步骤创建机器人：
- 在控制台点击"创建应用"
- 选择"机器人"应用类型
- 填写应用基本信息（名称、描述等）
- 创建完成后，记录下AppID和AppSecret
4.3 配置nanobot支持QQ机器人
修改nanobot的配置文件来启用QQ机器人功能：
# 编辑配置文件 vim /root/.nanobot/config.json找到channels配置部分，修改qq相关配置：
{ "channels": { "qq": { "enabled": true, "appId": "你的AppID", "secret": "你的AppSecret", "allowFrom": [] } } }将"你的AppID"和"你的AppSecret"替换为你在QQ开放平台获取的实际值。
4.4 启动gateway服务
配置完成后，需要启动nanobot的gateway服务：
# 启动gateway服务 nanobot gateway或者使用Docker方式启动：
docker run -v ~/.nanobot:/root/.nanobot -p 18790:18790 nanobot gateway服务启动成功后，你会看到类似下面的输出：
Gateway服务启动在 0.0.0.0:18790 QQ机器人通道已启用4.5 测试QQ机器人功能
现在你可以向配置的QQ机器人发送消息了。尝试发送一些问题：
/help 查看帮助信息 你好，你是谁？ 当前时间是多少？机器人应该能够正常响应你的消息，如果遇到问题，可以查看日志来排查。
5. 常见问题与使用技巧
5.1 部署常见问题解决
问题1：Docker构建失败如果构建过程中出现错误，可以尝试：
# 清理Docker缓存 docker system prune -a # 重新构建，显示详细日志 docker build --no-cache -t nanobot . --progress=plain问题2：端口冲突如果18790端口被占用，可以修改配置中的端口号：
{ "gateway": { "host": "0.0.0.0", "port": 18791 } }5.2 性能优化建议
内存优化： 如果内存不足，可以调整模型参数：
{ "agents": { "defaults": { "maxTokens": 4096, "maxToolIterations": 10 } } }响应速度优化： 启用缓存和批量处理：
# 启动时添加缓存参数 nanobot gateway --cache-size 10005.3 日常使用技巧
批量处理命令： 你可以一次性输入多个指令，用分号分隔：
查看当前目录；列出文件；显示系统信息使用工作区功能： nanobot支持工作区概念，可以保存会话上下文：
# 指定工作区 nanobot agent -w my_workspace -m "你的问题"自定义工具扩展： 你还可以根据需要添加自定义工具，只需要在配置文件的tools部分进行相应配置。
6. 总结
通过以上5个步骤，你已经成功部署并配置了nanobot超轻量级AI助手。我们来快速回顾一下：
- 环境准备：确保系统满足要求并安装Docker
- 一键部署：克隆仓库并构建Docker镜像
- 基础测试：验证模型状态并进行初步对话
- 高级功能：配置并启用QQ机器人通道
- 优化使用：掌握常见问题解决和使用技巧
nanobot的最大优势在于其极简的设计和高效的性能。相比传统的重型AI助手，它更适合个人开发者、小团队或者资源有限的环境使用。
无论是作为个人学习助手、自动化脚本执行工具，还是智能客服机器人，nanobot都能提供稳定可靠的服务。而且由于其开源特性，你还可以根据自己的需求进行二次开发和定制。
获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。