QQ机器人开发全流程指南,涵盖技术选型、官方API与小程序接入。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:Qq。 它的用途是:QQ机器人开发全流程指南,涵盖技术选型、官方API与小程序接入。 完整的 Skill 内容见:https://321skill.com/skills/qq-x-5/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我想为我的游戏社群开发一个QQ机器人,用来发送活动通知和查询玩家数据,应该选择官方API还是OneBot?’ 它会为你详细对比两种技术路线的优缺点、适用场景和开发成本,帮助你做出决策。接着你可以问:‘如何开始开发官方机器人?’ 它会逐步引导你完成从平台注册、应用创建、获取Token到连接WebSocket网关的全过程。
介绍
本Skill旨在为开发者提供一站式QQ机器人开发指导,解决从技术路线选择到实际上线部署的全流程难题。它系统性地对比了官方Bot API与社区OneBot生态的优劣,帮助开发者根据项目需求做出合适的技术选型。 Skill详细拆解了官方机器人从注册、鉴权、连接WebSocket网关、配置Intents(订阅事件)到处理各种消息类型(包括Ark卡片)的每一个步骤,让开发者能够按图索骥,快速完成机器人上线。 它特别适合希望接入QQ官方开放平台的后端开发、全栈开发以及智能体开发者,尤其是那些需要为社群管理、自动化客服或游戏社区开发QQ机器人的团队。 使用前请确保已阅读并理解QQ开放平台的相关协议与规范,特别注意消息发送频率限制和内容安全审核要求,避免机器人被封禁。
核心特点
与零散的教程不同,本Skill将官方API与社区生态的对比、完整的上线流程以及QQ小程序/OAuth2.0接入整合在一个清晰的指南中,提供了从决策到实现的完整闭环。
注意事项
本Skill主要提供开发指南和流程说明,不包含可直接运行的机器人代码或一键部署脚本。
常见问题
QQ官方机器人和OneBot机器人哪个好?
官方机器人功能新、稳定,但限制多;OneBot生态丰富、社区活跃,适合快速实现常见功能。本Skill会帮你对比选择。
如何快速让QQ机器人上线并处理消息?
按照Skill内的全流程指南,从注册应用、获取鉴权、连接网关到处理消息事件,一步步操作即可。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/qq-x-5/raw/index.md 读取 Qq 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/qq-x-5/raw/index.md(查看排版版本)