跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Python

通过官方 API 搭建 QQ 群聊机器人

使用腾讯 QQ 开放平台官方 API 搭建 QQ 群聊机器人的完整流程。内容包括注册机器人、配置沙箱与权限、获取 AppID 及密钥、拉取 GitHub 项目源码、配置图床服务、创建 Conda 虚拟环境并安装依赖,最后运行客户端实现群内指令响应、天气查询及图片发送等功能。

内存管理发布于 2026/4/6更新于 2026/9/3103 浏览
通过官方 API 搭建 QQ 群聊机器人

简介

基于官方 API 实现了 QQ 群聊机器人 Demo,具备获取天气、简单编辑待办、从本地发送图片等功能。

获取

机器人 demo

GitHub 仓库:GitHub - ClovertaTheTrilobita/SanYeCao-bot: 一个基于官方 API 的 QQ 群聊机器人

官方 SDK

GitHub 仓库:GitHub - tencent-connect/botpy: QQ 频道机器人 PythonSDK

教程

前置需求

本项目使用 conda 环境和 git 操作。请确保已安装这两个工具。

一、配置 QQ 开放平台

网址:QQ 开放平台

1. 机器人设置

完成注册之后,登陆,进入主页,点击创建机器人。

文章配图

简单填写好资料之后,进入机器人控制面板,找到'沙箱配置'。

文章配图

点击进入,选择你想在哪个群里测试你的 qq 机器人。

文章配图

注意,你必须是该群的群主或者管理员。

在你选择的群聊中,打开群聊设置>群机器人,选择其它,可以看到你创建的机器人。将它邀请进群。

下一步,在导航栏中找到'发布设置'。

文章配图

点击功能配置。

之后点击右上角的重新配置,设置机器人被 at 后输入栏上方会弹出的指令。需要根据代码来配置。

以下是我配置的。

文章配图

最后,在导航栏中找到'开发设置'。

文章配图

查看你的机器人的 AppID 和 AppSecret。由于 AppSecret 不会明文保存在网页上,刚创建的机器人需要点击'生成',并将生成的密钥记录下来,我们在之后的步骤中要用。

注意:生成密钥后退出页面将无法再次查看密钥,所以请妥善记录并保管好。

二、拉取项目

进入 GitHub,点击绿色的<>code

文章配图

之后复制项目仓库链接

文章配图

之后在自己的文件夹空白处右键,选择 open git bash here

文章配图

输入

git clone https://github.com/ClovertaTheTrilobita/SanYeCao-bot.git

文章配图

将项目拉取至本地。

三、启动机器人

很好!现在我们拿到了机器人的源代码,只需要启动它就行了。

请详细阅读项目的 README.md 根据指引配置 API 和其它一些东西。

1. 配置机器人账号密码

找到 ./botpy/examples/config.yaml

文章配图

appid: "Your_Bot_Id"
secret: "Enter_Your_Secret_Here"

还记得第一步中我们保存的机器人 ID 和密钥么?

将你在 QQ 开放平台上的 AppID 和 AppSecret 分别填入 Your_Id 和 Enter_Your_Secret_Here 的位置。

2. 配置图床 API

首先打开图床:Image Upload - SM.MS - Simple Free Image Hosting

注册/登陆之后,在右上角找到 User

文章配图

单击,点击 DashBoard

文章配图

在左侧导航栏中找到 API Token,如果是第一次使用需要点击 Generate Secret Token 生成令牌。

文章配图

复制你的令牌,进入项目。

在 ./botpy/examples/plugins/img_upload.py 中,找到

headers = {'Authorization': 'Your_Token'} # 此处填写你的 API Token

将上述代码中的 Your_Token 改为你刚刚复制的令牌。

文章配图

这样我们就完成了机器人 API 的配置。

3. 配置 conda 环境(推荐)

接下来,我们回到项目根目录,打开终端,输入

conda create -n chatbot

创建一个名为 chatbot 的环境,如果你想起别的名字就请把 chatbot 换为你喜欢的名字。

之后在终端输入

conda activate chatbot

启动我们刚刚创建的环境。

刚刚创建的 conda 环境貌似是没有 pip 安装器的,所以我们要

conda install pip

安装 pip

最后一步,在项目根目录输入

pip install -r requirements.txt

安装所需要的软件包。

requirements.txt内的包可能看起来很多,实际上大部分都是 conda 环境自带的。

4. 启动机器人

非常棒!现在我们已经完成了所有所需要的配置!

我们只需要进入 ./botpy/examples 目录,找到 client.py。在终端中输入

python client.py

启动机器人。

现在你就可以在群聊中 at 它啦。

目录

  1. 简介
  2. 获取
  3. 机器人 demo
  4. 官方 SDK
  5. 教程
  6. 前置需求
  7. 一、配置 QQ 开放平台
  8. 1. 机器人设置
  9. 二、拉取项目
  10. 三、启动机器人
  11. 1. 配置机器人账号密码
  12. 2. 配置图床 API
  13. 3. 配置 conda 环境(推荐)
  14. 4. 启动机器人

更多推荐文章

查看全部
  • 金仓数据库 ksql 本地库创建与管理指南
  • AI 辅助编程时代,新手能否替代资深开发者?实证研究给出答案
  • GitHub Copilot 编程助手完整使用教程
  • 242-267 GHz 双基地超外差雷达系统:65nm CMOS 太赫兹传感与成像实现
  • LangChain4j 集成国产大模型:通义千问、文心一言与智谱 AI 实践
  • 量化、算子融合与内存映射:C 语言实现边缘 AI 推理的三大核心优化
  • Linux 系统下 Tomcat 结合内网穿透实现 Web 应用公网访问
  • 论文阅读--Agent AI 探索多模态交互的前沿领域(一)
  • GitHub Copilot 提示词工程实战:从入门到精通
  • Agent AI 多模态交互前沿领域探索(二)
  • Agent AI 探索多模态交互前沿领域综述
  • 基于城市场景下无人机三维路径规划的导航变量多目标粒子群优化算法 NMOPSO 研究
  • Git 常用操作命令速查手册
  • 利用浏览器插件 Web Scraper 抓取知乎评论数据
  • Uniapp 微信小程序饰品商城系统设计与实现(PHP/Python)
  • 论文阅读:FR-LLM 多任务大模型用于联合故障诊断与 RUL 预测
  • OpenClaw 集成飞书机器人实战指南
  • Circle Loss:统一 Softmax 与 Triplet 的优化视角
  • Visual C++ 运行库安装与故障排查指南
  • WhisperLiveKit 实战指南:从本地部署到生产环境

相关免费在线工具

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online