新手教程：nanobot超轻量部署与使用，从安装到QQ机器人配置

新手教程：nanobot超轻量部署与使用，从安装到QQ机器人配置

1. 为什么你需要一个轻量级AI助手

想象一下，你希望拥有一个能帮你查资料、写代码、管理文件，甚至能接入QQ聊天的智能助手。但一看到那些动辄需要几十万行代码、部署复杂、资源消耗巨大的项目，是不是瞬间就头大了？

今天要介绍的nanobot，就是为了解决这个痛点而生的。它就像一个“迷你版”的智能大脑，核心代码只有大约4000行，比市面上一些主流方案的代码量少了99%以上。这意味着什么？意味着它部署快、运行稳、资源省，普通电脑也能轻松跑起来。

更重要的是，这个镜像已经为你准备好了所有东西：一个性能不错的Qwen3-4B模型、一个友好的网页聊天界面，以及接入QQ机器人的完整通道。你只需要跟着这篇教程，花上一点时间，就能拥有一个属于自己的、随时待命的AI伙伴。

2. 环境准备与一键启动

2.1 获取并启动镜像

首先，你需要在CSDN星图镜像广场找到名为“🐈 nanobot：超轻量级OpenClaw”的镜像。点击“一键部署”或类似的启动按钮。这个过程非常简单，就像安装一个普通软件一样，系统会自动为你准备好运行环境。

等待几分钟，当控制台显示服务启动成功的提示后，你的nanobot就已经在后台运行起来了。

2.2 确认模型服务已就绪

部署完成后，第一件事是确认核心的AI模型是否加载成功。模型是AI助手的“大脑”，它必须正常启动，后续的所有功能才能工作。

打开镜像提供的Webshell（网页终端），输入以下命令来查看服务日志：

cat /root/workspace/llm.log

如果看到日志中显示模型加载完成、服务已启动之类的信息，就说明最关键的模型服务已经准备就绪了。这一步是基础，确保它成功，后面的所有操作才有意义。

3. 快速上手：与你的AI助手对话

3.1 打开聊天界面

模型服务启动后，nanobot会提供一个基于Chainlit的Web聊天界面。你可以在镜像详情页找到访问这个界面的链接，通常是一个IP地址加端口号的形式。

点击链接，一个简洁、现代的聊天窗口就会在你的浏览器中打开。这就是你和nanobot对话的主界面。

3.2 进行第一次对话测试

现在，让我们来试试它的“智商”。在聊天框里，你可以像和朋友聊天一样提问。为了测试它是否真的能理解指令并执行操作，我们可以问一个稍微“硬核”点的问题。

尝试输入以下指令：

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

然后发送。nanobot会理解你的指令，调用系统命令来查看显卡信息，并将结果返回给你。如果它成功返回了显卡的型号、显存使用情况等信息，恭喜你，你的AI助手不仅会聊天，还能帮你干活了！

你可以继续尝试其他问题，比如：

• “今天的日期和星期几？”
• “帮我写一个Python函数，用来计算列表的平均值。”
• “当前目录下有哪些文件？”

通过这些测试，你能快速感受到nanobot将自然语言指令转化为实际行动的能力。

4. 功能升级：将AI助手变成QQ机器人

让AI助手待在网页里固然方便，但如果它能进驻我们最常用的QQ，随时在群里或私聊中响应，那实用性就大大提升了。nanobot支持这个功能，配置过程也不复杂。

4.1 准备工作：获取QQ机器人的“钥匙”

要让nanobot连接QQ，你需要先去QQ开放平台申请一个机器人应用，这相当于为你的机器人获取一个合法的身份ID和密码。

1. 访问平台：打开QQ开放平台官网（https://q.qq.com/#/apps）。
2. 注册开发者：使用你的QQ号登录并完成开发者注册（个人开发者即可）。
3. 创建应用：在控制台点击“创建应用”，选择“机器人”类型，填写应用名称等基本信息。
4. 获取凭证：创建成功后，在应用详情页的“开发管理”部分，你会找到至关重要的AppID和AppSecret。把它们记下来，这是下一步配置的关键。

4.2 关键配置：告诉nanobot如何连接QQ

拿到“钥匙”后，我们需要修改nanobot的配置文件，把这些信息填进去。

通过Webshell，使用vim编辑器打开配置文件：

vim /root/.nanobot/config.json

在这个配置文件里，找到channels配置部分。你需要添加或修改关于QQ的配置，让它看起来像下面这样：

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

请务必将YOUR_APP_ID和YOUR_APP_SECRET替换成你刚才从QQ开放平台记下来的那两串字符。allowFrom列表如果为空，表示允许接收所有好友和群的消息；你也可以在这里填入特定的QQ号来限制接收范围。

4.3 启动网关：开启QQ通讯服务

配置保存后，nanobot需要一个专门的“网关”服务来处理来自QQ的消息。在Webshell中运行以下命令来启动它：

nanobot gateway

如果启动成功，你会看到服务监听端口的提示信息。这个网关服务会常驻运行，负责接收QQ消息并转发给nanobot大脑处理，再将回复传回QQ。

4.4 大功告成：与你的QQ机器人聊天

现在，一切就绪。打开QQ，找到你刚刚创建的机器人账号（或将它拉入群中），像正常聊天一样给它发送消息吧。

无论是问它天气、让它讲个笑话，还是像之前一样让它执行“查看系统信息”这类指令，它都能通过nanobot进行智能回复。你会发现，这个轻量级的小家伙，在QQ里同样反应迅速、能力在线。

5. 总结：你的个人AI助手已上线

回顾一下，我们完成了几件大事：

1. 一键部署：快速启动了一个超轻量的AI助手核心。
2. 验证测试：通过网页聊天界面，确认了它的对话与指令执行能力。
3. 功能扩展：成功将其接入QQ，打造了一个24小时在线的智能聊天机器人。

nanobot的魅力在于它的“小而美”。它没有令人望而生畏的复杂度，却提供了最核心、最实用的智能助理功能。对于开发者，它是一个可以快速集成和二次开发的智能模块；对于普通用户，它是一个触手可及、能真实解决小问题的AI伙伴。

你可以基于这个基础，继续探索它的更多可能性，比如让它学习你的工作流，或者结合其他工具实现自动化。一个属于你的数字助手，已经准备就绪。

获取更多AI镜像

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