nanobot部署教程：从Docker run到QQ机器人上线的30分钟完整流程

想不想拥有一个属于自己的AI助手，不仅能通过网页聊天，还能集成到QQ里，随时随地问它问题？今天，我就带你手把手搞定这件事。整个过程比你想象的要简单，从拉取镜像到让QQ机器人开口说话，30分钟绰绰有余。

我们要部署的主角叫 nanobot。你可以把它理解为一个“迷你版”的智能大脑，它内置了强大的Qwen3-4B-Instruct模型，但整个系统的代码量却非常精简，只有大约4000行。这意味着它部署快、资源占用少，特别适合个人开发者或者想快速体验AI助手的朋友。

简单来说，这篇教程会带你走通这三步：

1. 快速启动：用一条Docker命令，把包含模型和nanobot的完整环境跑起来。
2. 基础验证：通过Web界面和它聊聊天，确认核心的AI对话功能正常。
3. 功能扩展：把它变成一个QQ机器人，让你的AI助手入驻QQ群或私聊。

准备好了吗？我们开始吧。

1. 环境准备与一键部署

部署的第一步，我们需要一个已经安装好Docker的环境。如果你还没有，可以搜索“Docker安装教程”，根据你的操作系统（Windows/macOS/Linux）快速安装一下，这里就不展开了。

假设你的Docker已经就绪，那么最激动人心的时刻来了——启动服务。我们只需要一条命令：

docker run -d -p 7860:7860 -p 8000:8000 --name my_nanobot csdn/nanobot:latest

我来解释一下这条命令在干什么：

• docker run -d：在后台（-d 代表 detached）运行一个容器。
• -p 7860:7860：把容器内部的7860端口映射到你电脑的7860端口。这个端口通常是给Chainlit的Web界面用的。
• -p 8000:8000：把容器内部的8000端口也映射出来。这个端口可能用于nanobot的网关（gateway）服务或其他API。
• --name my_nanobot：给这个容器起个名字，方便后续管理，比如停止或删除容器。
• csdn/nanobot:latest：指定要运行的镜像名称和标签，这里就是我们要用的nanobot最新版镜像。

执行这条命令后，Docker会自动从镜像仓库拉取镜像并启动。你可以通过 docker ps 命令查看容器是否在正常运行。

2. 验证核心AI服务

容器跑起来后，我们得先确认里面的“大脑”——也就是大模型服务——是否成功启动了。因为所有智能对话的能力都依赖于它。

2.1 检查模型服务日志

进入容器的命令行环境，查看模型服务的启动日志是最直接的方法。

# 进入正在运行的容器
docker exec -it my_nanobot bash

# 查看模型服务的日志文件
cat /root/workspace/llm.log

如果一切顺利，你会在日志中看到模型加载成功的相关信息，比如显示模型名称、占用显存大小等。这表示AI的“思考”引擎已经就绪。

2.2 访问Web聊天界面

模型服务好了，我们来试试最直观的聊天功能。nanobot使用了Chainlit来提供Web交互界面。

1. 打开你的浏览器。
2. 在地址栏输入：http://你的服务器IP地址:7860。如果你是在自己的电脑上部署的，就输入 http://localhost:7860。
3. 你应该能看到一个简洁的聊天界面。

2.3 进行首次对话测试

在聊天框里，尝试问它一个问题。比如，我们可以让它执行一个简单的系统命令来看看它的“工具调用”能力：

请使用 nvidia-smi 命令查看一下显卡配置。

输入后，nanobot会理解你的指令，调用相应的工具（在这个例子里是执行shell命令），并将结果返回给你。如果它能正确返回显卡信息，那就恭喜你，核心的AI智能体功能完全正常！

至此，一个具备基础对话和工具调用能力的AI助手就已经部署成功了。但如果我们想让它更贴近日常使用，比如在QQ里直接调用，就需要进行下一步。

3. 配置QQ机器人功能

让nanobot接入QQ，变成你的私人或群聊助手，这个过程需要一些配置，但每一步都很清晰。

3.1 创建QQ机器人应用

首先，我们需要在QQ开放平台创建一个机器人应用，以获取必要的身份凭证。

1. 访问 QQ开放平台。
2. 使用QQ号登录，并完成开发者注册（个人开发者即可）。
3. 点击“创建应用”，选择“机器人”应用类型。
4. 填写应用名称、描述等基本信息，然后创建。

3.2 获取关键凭证（AppID和AppSecret）

应用创建成功后，进入“开发管理”页面。在这里，你会找到两个最重要的信息：AppID 和 AppSecret。把它们妥善复制保存下来，下一步配置需要用到。

3.3 修改nanobot配置文件

现在，我们需要告诉nanobot关于QQ机器人的配置信息。回到你的容器内部操作。

# 如果已退出容器，再次进入
docker exec -it my_nanobot bash

# 使用vim编辑nanobot的配置文件
vim /root/.nanobot/config.json

在打开的配置文件中，你需要找到或添加 channels 配置部分，特别是 qq 的配置。将其修改为如下结构：

{
  "channels": {
    "qq": {
      "enabled": true, // 启用QQ通道
      "appId": "YOUR_APP_ID", // 替换为你的AppID
      "secret": "YOUR_APP_SECRET", // 替换为你的AppSecret
      "allowFrom": [] // 可以留空，或填写允许接收消息的QQ号/群号
    }
  }
}

注意：请务必将 YOUR_APP_ID 和 YOUR_APP_SECRET 替换成你从QQ开放平台实际获取的那一串字符。

3.4 启动网关服务

配置完成后，nanobot需要一个“网关”服务来处理来自QQ的消息和请求。在容器内启动它：

nanobot gateway

如果启动成功，终端会显示服务正在监听某个端口（例如8000）的日志信息。这个网关服务就是nanobot与QQ平台通信的桥梁。

3.5 在QQ中测试机器人

最后一步，就是愉快的测试环节了。

1. 在QQ中，找到你创建的机器人账号，或者将它拉入一个测试群。
2. @机器人或者直接私聊它，发送一个问题，比如：“你好，介绍一下你自己”。
3. 稍等片刻，你应该就能收到来自nanobot的智能回复了！

看到QQ对话框里弹出AI生成的回答时，整个部署流程就圆满成功了。你已经拥有了一个跨平台的个人AI助手。

4. 总结与后续建议

回顾一下，我们在这30分钟内完成了：

• 一键部署：用Docker快速搭建了包含大模型和nanobot框架的完整环境。
• 功能验证：通过Web界面测试了核心的AI对话和工具调用能力。
• 生态扩展：通过配置，成功将AI助手接入了QQ，拓展了使用场景。

nanobot这个项目的优势在于“轻量”和“够用”。它没有追求大而全，而是聚焦于提供一个能快速跑起来的AI代理核心，这让学习和部署的成本变得很低。

如果你还想继续探索：

• 更多工具：可以研究如何为nanobot添加自定义的工具函数，让它能处理更特定的任务，比如查询天气、控制智能家居等。
• 其他通道：除了QQ，也可以研究配置文件，看是否支持接入其他通讯平台，如微信、Slack等。
• 模型更换：虽然镜像内置了Qwen模型，但你可以了解如何修改配置，让其使用其他兼容的开放大模型。

遇到任何问题，或者有改进的想法，可以查阅项目的相关文档或社区。技术就是在这样一次次的搭建、调试和优化中进步的。现在，去享受你的私人AI助手带来的便利吧！

---

获取更多AI镜像

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