nanobot详细步骤：从QQ开放平台注册、App申请到nanobot gateway启动全流程

1. nanobot简介与核心特性

nanobot是一款受OpenClaw启发的超轻量级个人人工智能助手，专为开发者提供简单高效的AI代理服务。这个工具最大的特点就是极其轻量，仅需约4000行代码就能提供核心代理功能，相比其他类似工具动辄数十万行的代码量，体积小了99%以上。

目前实时代码行数为3510行，你可以随时运行bash core_agent_lines.sh命令进行验证。nanobot内置了vllm部署的Qwen3-4B-Instruct-2507模型，使用chainlit作为推理界面，让你能够轻松调用AI能力进行各种任务处理。

最吸引人的是，nanobot支持自行配置QQ聊天机器人，让你能够将AI助手集成到日常的聊天工具中，实现更加便捷的交互体验。

2. 环境准备与基础使用

2.1 验证模型部署状态

在开始配置QQ机器人之前，首先需要确认nanobot的核心服务已经正常部署。通过webshell连接到你的服务器，执行以下命令查看模型服务状态：

cat /root/workspace/llm.log

如果看到类似下面的输出，说明模型服务已经部署成功：

模型加载完成，服务启动成功
推理服务正常运行中

这个日志文件会显示模型加载的详细过程和最终状态，确保核心AI功能可用后再进行后续配置。

2.2 使用chainlit测试nanobot

nanobot使用chainlit作为用户交互界面，你可以通过以下方式测试基础功能：

打开chainlit界面后，你会看到一个简洁的聊天窗口。在这里你可以直接向nanobot提问，比如尝试输入：

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

nanobot会理解你的指令并返回相应的系统信息。这个测试很重要，它能验证整个AI推理链路是否正常工作。

第一次使用可能会有些延迟，因为模型需要加载到内存中。后续请求会快很多，通常能在几秒内得到回复。

3. QQ机器人配置全流程

3.1 注册QQ开放平台账号

要使用QQ机器人功能，首先需要访问QQ开放平台进行注册：

打开浏览器访问 https://q.qq.com/#/apps，点击注册按钮。你可以选择个人开发者或企业开发者身份，个人使用选择个人开发者即可。

注册过程中需要准备手机号进行验证，以及基本的个人信息。整个过程大约需要10-15分钟，包括邮箱验证、手机验证等步骤。

注册完成后，记得完善开发者资料，这有助于后续审核通过。平台可能会要求进行实名认证，按照提示操作即可。

3.2 创建机器人应用

登录QQ开放平台后，进入控制台页面，点击"创建应用"按钮。选择"机器人"类型，这是专门为聊天机器人设计的应用类型。

填写应用基本信息时，注意以下几点：

• 应用名称：取一个容易识别的名字
• 应用描述：简要说明用途，比如"个人AI助手"
• 应用图标：上传一个合适的图标

创建完成后，平台会自动生成AppID和AppSecret，这两个信息后面配置时会用到。

3.3 获取关键配置信息

在应用管理页面，找到"开发管理"选项卡，这里可以看到你的AppID和AppSecret。这两个字符串是连接nanobot和QQ平台的关键凭证。

重要提示：AppSecret是敏感信息，不要泄露给他人。如果怀疑密钥泄露，可以在平台重新生成新的密钥。

建议将这两个信息复制到安全的地方，比如本地文本文件，但不要上传到公开仓库或分享给他人。

3.4 配置nanobot连接QQ机器人

现在开始配置nanobot来连接刚刚创建的QQ机器人应用。通过ssh连接到你的服务器，编辑nanobot的配置文件：

vim /root/.nanobot/config.json

找到channels配置部分，添加或修改qq相关的配置项：

{
  "channels": {
    "qq": {
      "enabled": true,
      "appId": "你的AppID",
      "secret": "你的AppSecret", 
      "allowFrom": []
    }
  }
}

配置说明：

• enabled: 设置为true启用QQ通道
• appId: 填写你在QQ开放平台获取的AppID
• secret: 填写对应的AppSecret
• allowFrom: 可以设置允许使用的QQ号列表，留空表示允许所有人使用

保存退出后，配置就完成了。建议再次检查AppID和AppSecret是否正确，错误的凭证会导致连接失败。

3.5 启动gateway服务

配置完成后，需要启动nanobot的gateway服务来建立与QQ平台的连接：

nanobot gateway

如果一切配置正确，你会看到服务启动成功的提示信息，包括连接状态、服务端口等详细信息。

服务启动后，nanobot就会开始监听QQ消息。你可以在QQ中给你的机器人发送消息测试，看看是否能正常回复。

第一次启动可能需要一些时间来建立连接，如果遇到连接问题，检查网络配置和防火墙设置。

3.6 测试QQ机器人功能

现在可以向你的QQ机器人提问了。打开QQ，找到你创建的机器人账号，发送任何问题测试功能：

例如尝试问一些简单问题：

• "你好，你是谁？"
• "现在几点了？"
• "帮我查一下天气"

如果配置成功，nanobot会通过QQ回复你的消息。你可以测试各种类型的问题，看看机器人的响应效果。

4. 常见问题与故障排除

在配置和使用过程中，可能会遇到一些常见问题：

连接失败：检查AppID和AppSecret是否正确，网络连接是否正常。

消息无响应：确认gateway服务正常运行，查看服务日志排查问题。

回复延迟：可能是模型推理时间较长，可以尝试优化服务器配置。

如果遇到无法解决的问题，可以通过提供的联系方式寻求帮助。记得描述清楚问题现象和已经尝试的解决方法。

5. 使用建议与最佳实践

为了获得更好的使用体验，这里有一些建议：

权限管理：在生产环境中，建议在allowFrom列表中指定允许使用的QQ号，避免未授权访问。

性能优化：如果响应速度较慢，可以考虑升级服务器配置或优化模型参数。

日志监控：定期检查服务日志，及时发现和处理异常情况。

备份配置：定期备份配置文件，避免配置丢失导致服务中断。

记住这是一个学习研究用的工具，不要用于商业用途或违反相关规定的场景。

---

获取更多AI镜像

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