跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonAI

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

使用腾讯 QQ 开放平台官方 API 搭建 QQ 群聊机器人的完整流程。内容包括在 QQ 开放平台注册并配置沙箱环境,拉取 GitHub 项目源码,配置 AppID 与密钥,设置图床 API Token,以及使用 Conda 创建虚拟环境安装依赖。最后通过运行 Python 脚本启动机器人,实现天气查询、待办编辑及图片发送等功能。

月亮邮递员发布于 2026/4/6更新于 2026/5/2228 浏览
通过官方 API 搭建 QQ 群聊机器人

简介

使用官方 API 搭建了一个 QQ 群聊机器人的 Demo,具备获取天气、简单编辑待办、从本地发送图片等功能。

资源

机器人源码

GitHub 仓库:SanYeCao-bot

官方 SDK

GitHub 仓库:botpy

教程

前置需求

本项目使用 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_Bot_Id 和 Enter_Your_Secret_Here 的位置。

2. 配置图床 API

首先打开图床: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 环境(推荐)

接下来,我们回到项目根目录,打开终端,输入以下命令创建一个名为 chatbot 的环境:

conda create -n chatbot

如果你想起别的名字就请把 chatbot 换为你喜欢的名字。

之后在终端输入以下命令启动我们刚刚创建的环境:

conda activate chatbot

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

conda install pip

最后一步,在项目根目录输入以下命令安装所需要的软件包:

pip install -r requirements.txt

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

4. 启动机器人

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

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

python client.py

启动机器人。

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

目录

  1. 简介
  2. 资源
  3. 机器人源码
  4. 官方 SDK
  5. 教程
  6. 前置需求
  7. 一、配置 QQ 开放平台
  8. 1. 机器人设置
  9. 二、拉取项目
  10. 三、启动机器人
  11. 1. 配置机器人账号密码
  12. 2. 配置图床 API
  13. 3. 配置 Conda 环境(推荐)
  14. 4. 启动机器人
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • Visual Studio 2022 无法使用 GitHub Copilot 的排查与解决
  • PyMAVLink 无人机通信 Python 库使用指南
  • NewStar CTF Web 比赛题目解析与解题思路
  • Spring Boot Redis 存储对象报 ClassCastException 问题排查与解决
  • DankDroneDownloader 无人机固件管理工具技术解析
  • SenseVoice Small 语音情感识别:WebUI 使用与二次开发
  • 基于 Python 的小红书公开数据采集方法
  • FPGA 跨时钟域 CDC 处理的 3 种常用工程方案
  • CSS 基础:width 与 height 尺寸属性详解
  • OpenClaw 集成飞书机器人实战指南
  • Spark SQL 整合 Hive 配置与使用
  • 大语言模型联邦微调综述:挑战、方法与未来方向
  • 基于 Spring Boot 3.3 的 Java AI Agent Gateway 实践
  • node-llama-cpp 安装与配置:Windows、Linux 和 Mac 全平台教程
  • OpenClaw 多平台卸载指南(Windows/macOS/Linux/npm/pnpm)
  • YOLO26 实时目标检测的关键架构改进与性能基准测试
  • 低代码治理实践:构建 Power Platform 中心化管控体系
  • Mixtral 8X7B Instruct v0.1 llamafile 部署与应用实战指南
  • Elasticsearch 与 Kibana 实战:安装部署及 C++ 客户端封装
  • 本地部署 Z-Image-Turbo AI 绘画快速入门指南

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • curl 转代码

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

  • Base64 字符串编码/解码

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

  • Base64 文件转换器

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