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.io

2.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开放平台账号：

1. 访问QQ开放平台：https://q.qq.com/#/apps
2. 注册个人或企业开发者账号（个人开发者即可）
3. 完成实名认证和相关资料填写

4.2 创建QQ机器人应用

注册完成后，按照以下步骤创建机器人：

1. 在控制台点击"创建应用"
2. 选择"机器人"应用类型
3. 填写应用基本信息（名称、描述等）
4. 创建完成后，记录下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 1000

5.3 日常使用技巧

批量处理命令： 你可以一次性输入多个指令，用分号分隔：

查看当前目录；列出文件；显示系统信息

使用工作区功能： nanobot支持工作区概念，可以保存会话上下文：

# 指定工作区 nanobot agent -w my_workspace -m "你的问题"

自定义工具扩展： 你还可以根据需要添加自定义工具，只需要在配置文件的tools部分进行相应配置。

6. 总结

通过以上5个步骤，你已经成功部署并配置了nanobot超轻量级AI助手。我们来快速回顾一下：

1. 环境准备：确保系统满足要求并安装Docker
2. 一键部署：克隆仓库并构建Docker镜像
3. 基础测试：验证模型状态并进行初步对话
4. 高级功能：配置并启用QQ机器人通道
5. 优化使用：掌握常见问题解决和使用技巧

nanobot的最大优势在于其极简的设计和高效的性能。相比传统的重型AI助手，它更适合个人开发者、小团队或者资源有限的环境使用。

无论是作为个人学习助手、自动化脚本执行工具，还是智能客服机器人，nanobot都能提供稳定可靠的服务。而且由于其开源特性，你还可以根据自己的需求进行二次开发和定制。

---

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。