QQ机器人开发一站式指南,涵盖技术选型、官方API接入与小程序开发。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:Qq。 它的用途是:QQ机器人开发一站式指南,涵盖技术选型、官方API接入与小程序开发。 完整的 Skill 内容见:https://321skill.com/skills/qq-x-4/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我想为我的游戏社群创建一个QQ机器人,能自动欢迎新成员并回答常见问题,应该选官方API还是OneBot?” 它会为你分析两种技术路线的优缺点、实现成本与长期维护考量。接着你可以问:“如何用官方API实现发送带按钮的Ark卡片消息?” 它会引导你查看鉴权流程、消息类型文档并给出代码结构示例。
介绍
本Skill旨在解决开发者在构建QQ机器人时面临的技术路线选择困惑与接入流程复杂的问题。它系统性地梳理了官方Bot API与社区OneBot生态的差异,帮助开发者根据自身需求选择合适的技术栈。 Skill详细拆解了官方机器人从注册、鉴权、连接到消息处理的全流程,包括WebSocket网关连接、Intents权限设置、各类消息格式(如Ark卡片)的发送与接收,降低了官方API的上手门槛。 它非常适合希望为QQ群或频道开发自动化管理工具、互动游戏或客服机器人的开发者,无论是个人爱好者还是企业团队,都能从中找到清晰的实现路径。 使用建议:建议先通读Skill中的技术路线对比部分,明确项目需求后再选择具体实现方案;开发过程中,注意关注QQ开放平台的API更新与政策变动。
核心特点
本Skill不仅提供官方API的接入教程,还重点对比了官方方案与社区流行的OneBot生态,帮助开发者做出更符合项目长期维护需求的技术选型决策。同时,它涵盖了从小程序OAuth2.0登录到机器人消息交互的完整QQ生态开发链路,内容更为全面。
注意事项
本Skill主要侧重于开发指南与流程梳理,不提供开箱即用的、封装好的机器人框架或SDK。
常见问题
QQ官方机器人和OneBot机器人有什么区别?
官方机器人功能新、稳定,但需审核;OneBot生态丰富、社区活跃,但依赖第三方实现。
如何快速创建一个能收发消息的QQ机器人?
可参照Skill中的“官方机器人全流程”部分,完成注册、创建应用、获取凭证并连接WebSocket网关。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/qq-x-4/raw/index.md 读取 Qq 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/qq-x-4/raw/index.md(查看排版版本)