QQ 官方机器人接入
以官方机器人身份接收和回复获授权的消息。
模型负责生成与推理；Agent 使用工具完成任务；Harness 管理 Agent 的运行环境；MCP 是连接工具与数据的协议；Skill 是可复用的任务指导。
当前任务
QQ 官方机器人接入
验收方法
以官方机器人身份接收和回复获授权的消息。
前置条件
需 AppID/AppSecret 换取 access_token；后端使用 QQBot 鉴权，弃用旧 Token。
API Key
需 AppID/AppSecret 换取 access_token；后端使用 QQBot 鉴权，弃用旧 Token。
模型 / 服务
采用本地模型的方案需另选具体型号并验证工具能力；设备连接本身不需要大模型。
Agent / 运行环境
仅列出已核验工具；AI 桥接与自主规划若未注明官方支持，属于待实现与待验证部分。
硬件
硬件需求随具体软件、模型、量化与任务变化；本轮无最低配置或流畅性能实测。
权限与风险
本地模型仍通过腾讯收发；只处理获准上下文，禁止全量导出群聊。
API Key
需 AppID/AppSecret 换取 access_token；后端使用 QQBot 鉴权，弃用旧 Token。
平台政策
官方 Bot 不是个人 QQ 协议接管；遵守审核和权限，禁止群发骚扰或绕过封禁。
运行方式
后端可本地或托管；回调网络另查事件资料，不改变现有机器人或 Tunnel。
验收方法
计划：先用本地合成响应测试错误码和过期；有独立测试凭证后再测一条许可消息与撤销。未执行。
验收方法
已核验官方资料，本站未执行该组合或设备实测。
边界与限制
群聊端点与事件验签资料未完整取得，禁止猜测；网络、费用和资格未知。
替代方案
若此方案不满足条件，可先完成只读或手动流程，再按下列替代项目重新核验；不继承当前兼容性。
替代方案
telegram-bot
line
discord
费用
待核验
价格尚未核验；软件、模型、API、硬件和托管费用需分别确认。
实施步骤
- 01用官方 v2 文档注册独立测试机器人，完成平台要求的审核。
- 02在后端保护密钥，检查访问凭证和业务错误码，不只看 HTTP 状态。
- 03只测试获准的合成消息；核验身份、msg_id、过期和停止行为后再加入模型。
接入方式
本站未实测
POST https://api.bot.qq.com/app/getAppAccessTokenPOST https://api.bot.qq.com/v2/users/{user_openid}/messages边界与限制
- 群聊端点与事件验签资料未完整取得，禁止猜测；网络、费用和资格未知。
- 已核验官方资料，本站未执行该组合或设备实测。
权限与风险
- 本地模型仍通过腾讯收发；只处理获准上下文，禁止全量导出群聊。
- 官方 Bot 不是个人 QQ 协议接管；遵守审核和权限，禁止群发骚扰或绕过封禁。
原始来源
- Tencent QQ 官方资料 · src-qq-v2-start ↗
bot.q.qq.com · 2026-10-16 · 官方文档说明
- Tencent QQ 官方资料 · src-qq-v2-token ↗
bot.q.qq.com · 2026-10-16 · 官方文档说明
- Tencent QQ 官方资料 · src-qq-v2-call-guide ↗
bot.q.qq.com · 2026-10-16 · 官方文档说明
- Tencent QQ 官方资料 · src-qq-v2-changelog ↗
bot.q.qq.com · 2026-10-16 · 官方文档说明