手把手教你搭建 QQ AI 智能助理，从部署到上线

AI机器人讨论
, , ,
1

周末折腾了两天，终于把 QQ AI 智能助理搭好了，分享下完整流程。

前置准备

  • 一台服务器（2C2G 起步就够）
  • Node.js >= 22
  • 腾讯 QQ 开放平台账号

第一步：部署 Agent 框架

推荐用云服务一键安装的方式，免去配置环境的折腾。本地安装也行，支持 macOS/Linux/WSL2。

第二步：QQ 机器人配置

  1. 登录 QQ 开放平台
  2. 创建一个机器人应用
  3. 获取 AppID 和 AppSecret
  4. 配置沙箱频道用于测试

第三步：接入 Agent

在 Agent 控制台安装 QQ Channel 插件，填入刚才的 AppID 和 AppSecret，保存后就能在 QQ 群里 @ 机器人对话了。

实际效果

  • 群里 @ 机器人可以直接提问
  • 支持多轮对话，有上下文记忆
  • 可以调用各种工具（搜索、写代码、生成图片等）

和其他方案对比

相比纯 API 调用的 QQ 机器人，Agent 方案最大的优势是能自主规划和执行多步骤任务，不只是一问一答。

注意事项

  • QQ 开放平台审核较严，建议先用沙箱测试
  • 模型响应时间会影响用户体验，建议用国内模型降低延迟
  • 注意 API 调用成本控制

有搭建问题可以留言讨论！

2

QQ 开放平台审核确实严，我提交了三次才过。建议机器人描述写详细点，说明是 AI 助手用途。

3

延迟问题怎么解决的？我用国外模型 API，QQ 群里回复要等好几秒。

4

内容扎实！正好想搭一个群里的 AI 助手。请问沙箱频道和正式频道切换方便吗？

1 个赞
5

我之前用 go-cqhttp 搭的 QQ 机器人，但经常掉线。Agent 方案会不会稳定一些？

6

多轮对话 + 上下文记忆这个很关键，纯 API 调用的机器人做不到这点。

1 个赞
7

API 成本控制这块建议加个每日限额，不然群里人一多刷起来成本爆炸。

8

遇到同样的bug了，等修复