@xsqm/pi-qqbot
连接QQ官方Bot API与本地Pi智能体的扩展
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@xsqm/pi-qqbot。 它的用途是：连接QQ官方Bot API与本地Pi智能体的扩展 完整的 Skill 内容见：https://321skill.com/skills/xsqm-pi-qqbot/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“当QQ群里有人问‘今天天气如何？’时，调用天气查询API获取信息并回复。”，它会通过此Skill监听到该关键词，触发你预设的天气查询逻辑，并将结果自动发送到QQ群中。
介绍
这个Skill解决了Pi智能体无法直接与QQ平台交互的问题。它作为一个桥梁，将QQ官方机器人API的通信能力接入到本地运行的Pi智能体，使得Pi能够接收QQ群或私聊消息，并通过Pi的代码处理能力进行智能回复，实现自动化客服、群管理或娱乐互动等功能。
使用方式相对直接，开发者需要在QQ开放平台申请机器人并获取密钥，然后在本地Pi环境中配置此Skill，将密钥等信息填入，启动后Skill便会建立连接，将QQ消息转发给Pi处理，并将Pi的回复传回QQ。
它非常适合已经熟悉Pi智能体开发、并希望将其能力扩展到QQ这一庞大用户平台的开发者或技术爱好者。无论是想为社群打造一个智能问答机器人，还是实现一些自动化的通知或管理任务，这个Skill都提供了基础框架。
使用建议方面，由于涉及网络通信和第三方API，请确保网络环境稳定，并妥善保管好QQ机器人的密钥。初期建议在测试群组中进行功能验证，注意遵守QQ平台的相关规范，避免发送频率过高或内容违规导致机器人被封禁。
核心特点
此Skill直接对接QQ官方Bot API，提供了稳定、合规的通信渠道，区别于一些依赖非官方协议或模拟客户端的方案，避免了因协议变动导致的不稳定风险。
注意事项
不适合需要高度定制化QQ客户端行为（如抢红包、复杂界面操作）或仅用于个人QQ号自动化聊天的场景。
常见问题
需要自己申请QQ机器人吗？
是的，需要前往QQ开放平台申请并获取必要的API密钥。
Pi能处理图片或语音消息吗？
这取决于QQ Bot API支持的消息类型以及Pi Skill中实现的解析逻辑，通常以文本交互为主。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/xsqm-pi-qqbot/raw/index.md 读取 @xsqm/pi-qqbot 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/xsqm-pi-qqbot/raw/index.md（查看排版版本）