OpenClaw安装教程进阶版：nanobot配置QQ机器人全流程（含AppID/Secret设置）

你是不是已经体验过OpenClaw的强大，但觉得它有点“重”？或者，你一直想拥有一个能接入QQ群聊的AI助手，却苦于配置复杂、代码量大？

今天，我要分享一个更轻量、更易上手的方案：nanobot。它被称为“超轻量级OpenClaw”，核心代码仅需约4000行，比原版小了99%。更重要的是，它内置了vLLM部署的Qwen3-4B-Instruct-2507模型，开箱即用，并且可以轻松配置成QQ聊天机器人。

这篇文章，我将带你走完从部署到配置QQ机器人的全流程，手把手教你如何让AI助手在你的QQ群里“活”起来。无论你是想用于技术交流群答疑，还是想打造一个有趣的娱乐机器人，这篇教程都能帮你实现。

1. nanobot是什么？为什么选择它？

在开始动手之前，我们先花一分钟了解一下nanobot到底是什么，以及它为什么值得你花时间。

nanobot 是一款受OpenClaw启发，但设计理念完全不同的个人AI助手。它的核心目标是极致的轻量与简洁。

• 代码极简：整个项目的核心代理功能代码仅约4000行（你可以随时运行 bash core_agent_lines.sh 验证，当前约3510行）。相比之下，Clawdbot的代码量高达43万行。这意味着更少的依赖、更快的启动速度和更低的资源占用。
• 开箱即用：它已经内置了通过vLLM高性能推理框架部署的 Qwen3-4B-Instruct-2507 模型。你不需要自己去折腾模型下载、环境配置、推理优化这些繁琐的步骤，启动服务就能直接对话。
• 易于扩展：虽然轻量，但架构清晰。它通过 Chainlit 提供了一个美观的Web聊天界面，更重要的是，它预留了便捷的通道（Channel）接口，让我们可以轻松地接入像QQ这样的第三方平台。

简单来说，如果你想要一个部署简单、运行轻快、又能灵活接入常用聊天工具的AI助手，nanobot是一个非常棒的选择。

2. 环境准备与快速验证

假设你已经通过CSDN星图镜像或其他方式，获取并启动了一个预装了nanobot的环境。我们第一步是确认一切就绪。

2.1 验证模型服务

模型是AI助手的大脑。nanobot使用vLLM在后台托管模型服务。我们需要先确认这个“大脑”已经成功启动并运行。

打开终端或WebShell，输入以下命令查看服务日志：

cat /root/workspace/llm.log

如果看到类似下图的输出，显示模型加载成功并正在监听端口，那么恭喜你，模型服务部署成功了！

2.2 体验Web聊天界面（Chainlit）

nanobot内置了Chainlit，这是一个非常漂亮的Python应用框架，专门用于构建聊天界面。我们可以用它来和AI进行初次对话，测试基本功能。

通常，Chainlit服务会在启动环境时自动运行。你可以在浏览器中访问指定的端口（例如 http://<你的服务器IP>:8000）来打开聊天界面。

打开后，你会看到一个简洁的聊天窗口，就像下面这样：

2.3 进行首次提问测试

让我们问一个简单但能体现AI“行动力”的问题。在输入框里键入：

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

点击发送。nanobot（背后的Qwen模型）会理解你的指令，并尝试在服务器环境中执行 nvidia-smi 命令，然后将结果返回给你。如果一切正常，你会看到类似下图的显卡信息反馈：

到这里，你已经成功运行了一个本地的、能执行简单命令的AI助手！ 但这还不够酷，接下来我们让它走进QQ，成为群聊里的“智能小伙伴”。

3. 核心实战：配置QQ机器人全流程

这是本教程最精彩的部分。我们将一步步申请QQ机器人权限，并将其与nanobot连接起来。

3.1 访问QQ开放平台并注册

QQ机器人的官方管理平台是 QQ开放平台。

1. 打开浏览器，访问：https://q.qq.com/#/apps
2. 使用你的QQ号登录。
3. 根据提示完成个人开发者或企业开发者的注册与实名认证。个人开发者完全足够用于学习和测试。

3.2 创建你的第一个机器人应用

注册认证成功后，我们开始创建机器人。

1. 在平台首页，点击“创建应用”。
2. 选择应用类型为“机器人”。
3. 填写应用名称、描述等基本信息，然后提交创建。

创建成功后，你会在应用列表中看到它，如下图所示：

3.3 获取关键凭证：AppID与AppSecret

机器人要和QQ服务器通信，需要身份凭证。这就是AppID和AppSecret。

1. 点击你刚创建的应用，进入“开发管理”或“机器人”管理页面。
2. 找到“基础信息”或“凭证与密钥”板块。
3. 这里你会看到 AppID 和 AppSecret（可能需要点击“查看”或“重置”来获取Secret）。

请立即妥善保存这两串字符，它们就像机器人的账号和密码，下一步配置要用到。

3.4 修改nanobot配置文件，注入QQ机器人能力

现在，我们要告诉nanobot：“嘿，这是QQ机器人的钥匙，去连接吧。”

nanobot的配置文件通常位于 /root/.nanobot/config.json。我们用文本编辑器（如vim）打开它：

vim /root/.nanobot/config.json

在这个JSON配置文件中，找到或添加 channels 配置部分。我们需要配置QQ通道 (qq)。

将你在上一步获取的 AppID 和 AppSecret 替换掉下面的 YOUR_APP_ID 和 YOUR_APP_SECRET。

{
  // ... 其他配置可能已存在 ...
  "channels": {
    "qq": {
      "enabled": true,           // 设置为 true 以启用QQ机器人
      "appId": "YOUR_APP_ID",    // 替换为你的真实AppID
      "secret": "YOUR_APP_SECRET", // 替换为你的真实AppSecret
      "allowFrom": []            // 可以留空，表示允许所有来源；或填入特定QQ群号进行限制
    }
  }
}

• enabled: true：开启QQ机器人功能。
• allowFrom: []：这是一个安全设置。如果数组为空 []，表示允许处理来自任何QQ群/私聊的消息。如果你想限制只处理特定群聊，可以把群号填进去，例如 ["123456789", "987654321"]。

修改完成后，保存并退出编辑器。

3.5 启动网关服务，建立连接

配置文件改好了，还需要一个“网关”服务来负责nanobot核心与QQ平台之间的消息转发。

在终端中运行以下命令启动网关：

nanobot gateway

如果一切配置正确，你会看到服务启动成功的日志，显示网关正在监听端口，等待连接。如下图所示：

这个 nanobot gateway 进程需要保持运行，它是机器人在线的关键。你可以使用 screen 或 systemd 等工具让它后台常驻。

3.6 大功告成：与QQ机器人对话

现在，最激动人心的时刻来了！

1. 打开QQ，找到你拥有管理权限的群（或者直接私聊你的机器人账号，如果平台支持）。
2. 在群里@你的机器人，或者直接给它发消息。
3. 输入一个问题，比如：“今天天气怎么样？”或者像我们之前测试的“用nvidia-smi看看显卡信息”。

稍等片刻，你就会收到nanobot通过QQ机器人发回的回复！效果就像下面这样：

看到这个回复，就说明你的个人AI助手已经成功入驻QQ，可以24小时为你的群友提供服务了！

4. 总结与后续玩法

回顾一下，我们完成了从零到一的跨越：

1. 了解nanobot：一个仅4000行代码的超轻量级AI助手，内置高性能模型。
2. 验证基础功能：通过Chainlit界面确认模型服务正常，并能执行简单指令。
3. 配置QQ机器人：申请平台权限、获取密钥、修改配置、启动网关，最终实现QQ群聊集成。

整个过程的核心就是配置文件的修改和网关服务的启动。nanobot的轻量设计让集成变得异常简单。

接下来，你可以尝试更多玩法：

• 自定义回复风格：通过修改系统提示词（system prompt），让机器人在QQ里扮演不同的角色，比如技术专家、段子手、客服助手等。
• 扩展功能：nanobot的架构允许你为其添加新的工具（Tools），比如查询天气、搜索资料、控制智能家居等，让机器人的能力更强。
• 权限管理：利用 allowFrom 配置，精确控制机器人响应哪些群聊或用户。
• 探索其他通道：除了QQ，nanobot理论上可以接入任何提供API的聊天平台，比如微信、Telegram等（需要自行开发或寻找适配插件）。

如果在配置过程中遇到任何问题，或者有改进的想法，欢迎通过项目提供的联系方式进行交流与反馈。

---

获取更多AI镜像

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