小白也能搞定！nanobot轻量AI助手从部署到使用完整教程

小白也能搞定！nanobot轻量AI助手从部署到使用完整教程

1. nanobot简介与核心特点

nanobot是一款受OpenClaw启发的超轻量级个人AI助手，专为追求高效简洁的用户设计。它最大的特点就是"小而美"——仅需约4000行代码就能提供完整的AI助手功能，比传统AI助手的代码量小了99%。

这个轻量级设计带来了几个明显优势：

• 部署简单：内置vllm部署的Qwen3-4B-Instruct-2507模型，开箱即用
• 资源占用低：对硬件要求不高，普通电脑也能流畅运行
• 扩展性强：支持通过简单配置接入QQ等聊天机器人
• 响应迅速：精简的代码结构确保了快速响应

你可以随时运行bash core_agent_lines.sh命令查看当前代码行数（最新版本约3510行），感受它的轻量化设计。

2. 快速部署与验证

2.1 部署后验证服务状态

部署完成后，第一步是确认模型服务是否正常运行。只需要执行一个简单命令：

cat /root/workspace/llm.log

如果看到服务启动成功的日志信息（通常包含"server started successfully"之类的提示），说明nanobot已经准备就绪。

2.2 使用chainlit交互界面

nanobot使用chainlit提供直观的Web交互界面。启动方式非常简单：

chainlit run app.py

启动后，在浏览器中访问显示的地址（通常是http://localhost:7860）就能看到交互界面。界面分为左右两部分：左侧是对话历史，右侧是输入框。

3. 基础使用教程

3.1 你的第一个问题

让我们从一个简单的系统命令开始体验：

使用nvidia-smi看一下显卡配置

输入这个问题后，nanobot会理解指令并返回显卡的详细信息。初次使用时，建议尝试这些基础命令：

• 系统状态查询：查看内存使用情况
• 文件操作：列出当前目录内容
• 网络检查：测试百度是否可达
• 简单计算：计算365乘以24等于多少

3.2 进阶功能体验

熟悉基础操作后，可以尝试更复杂的功能：

# 查找特定文件 在/home目录下查找所有的jpg图片 # 系统监控 显示过去一小时的CPU使用率 # 进程管理 找出占用内存最多的前3个进程

你会发现nanobot能理解自然语言指令，并将其转换为正确的系统命令执行。

4. 接入QQ机器人教程

4.1 准备工作

要将nanobot变成QQ机器人，需要先完成以下准备：

1. 访问QQ开放平台（https://q.qq.com/#/apps）
2. 注册开发者账号（个人或企业）
3. 创建机器人应用并获取AppID和AppSecret

4.2 配置nanobot

接下来修改nanobot的配置文件：

vim /root/.nanobot/config.json

找到或添加以下配置（替换YOUR_APP_ID和YOUR_APP_SECRET为实际值）：

{ "channels": { "qq": { "enabled": true, "appId": "YOUR_APP_ID", "secret": "YOUR_APP_SECRET", "allowFrom": [] } } }

allowFrom可以留空表示允许所有人使用，或添加特定QQ号进行限制。

4.3 启动gateway服务

配置完成后，启动gateway服务：

nanobot gateway

看到"gateway started"提示表示服务已启动。现在你的QQ机器人已经可以正常使用了。

4.4 测试机器人功能

添加机器人好友或邀请到群聊后，发送消息测试：

1. 简单问候："你好"
2. 系统命令："查看服务器时间"
3. 计算问题："100的平方是多少"

机器人会即时响应你的各种问题。

5. 常见问题解答

5.1 服务启动问题

问题：模型服务启动失败
解决：检查内存是否足够，查看llm.log中的具体错误信息

问题：chainlit界面无法打开
解决：确认端口是否被占用，尝试更换端口或检查防火墙设置

5.2 QQ机器人问题

问题：机器人不回复消息
解决：检查gateway服务是否正常运行，确认QQ平台配置正确

问题：配置文件修改无效
解决：确保修改后重启了gateway服务

5.3 性能优化建议

如果资源紧张，可以尝试：

• 减少同时处理的请求数量
• 关闭不必要的功能模块
• 定期清理日志文件释放空间

6. 总结与下一步

通过本教程，你已经掌握了：

1. nanobot的基本部署和验证方法
2. 使用chainlit界面进行交互
3. 配置QQ机器人的完整流程
4. 常见问题的解决方法

建议下一步：

• 尝试接入其他聊天平台（如微信、Telegram）
• 开发自定义功能扩展
• 参与开源社区贡献代码

获取更多AI镜像

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