简介
本文演示如何使用腾讯 QQ 开放平台官方 API 构建一个具备获取天气、编辑待办及发送本地图片功能的群聊机器人。项目基于 Python SDK 开发,适合希望快速上手机器人开发的开发者参考。
前置准备
本项目依赖 Conda 环境管理与 Git 版本控制工具。请确保本地已安装这两个工具,若未安装建议先查阅相关文档完成配置。
一、配置 QQ 开放平台
访问 QQ 开放平台 并完成注册登录。
1. 创建机器人
进入主页点击'创建机器人',填写基本信息后进入控制面板,找到'沙箱配置'。

在沙箱设置中选择测试群聊。注意:你必须是该群的群主或管理员。
邀请机器人进群:打开群设置 > 群机器人 > 其它,找到创建的机器人并邀请。
2. 功能与权限配置
导航栏选择'发布设置' > '功能配置',点击右上角重新配置。根据代码逻辑设置被@后的指令提示。

随后进入'开发设置',查看机器人的 AppID 和 AppSecret。

重要提示:AppSecret 不会明文保存,首次创建需点击'生成'并妥善记录密钥,退出页面后将无法再次查看。
二、拉取项目代码
前往 GitHub 仓库复制项目链接,在本地终端执行克隆命令。
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"
将第一步中获取的 AppID 和 AppSecret 填入对应位置。


