QQ 工具
需求
QQ 工具通过 Agent Core 内置 QQ 模块与 OneBot WebSocket 执行，具有真实外部副作用。仅在账号、群绑定和权限配置完成后使用。
架构
| 工具 | 参数 | 返回 | 权限与风险 |
|---|---|---|---|
qq_send | type,target 必填；按类型使用 content、file_url、file_name、face_id 或 sticker_group | {success}，失败含 error | 发送群聊/私聊/图片/文件；外部副作用 |
qq_info | type: group/members/user、target_id | 群信息、成员列表或用户信息 | 读取 QQ 元数据；注意隐私 |
request_game_action | 游戏操作请求参数以 Sub-Agent 当前 Schema 为准 | 转交主 Agent | 可能间接修改游戏世界 |
notify_qq / qq_notify | 目标群和消息以当前注册 Schema 为准 | 发送结果 | 主动通知；外部副作用 |
qq_group_manage | 操作与目标以当前 Schema 为准 | OneBot 操作结果 | 需管理员权限；踢人、禁言、撤回等高风险 |
qq_send.type 支持 group_msg、private_msg、image、file、face、sticker。直接执行函数不处理 sticker，该类型需要中间件解析；不要假设所有调用入口均可用。
执行
- 优先使用 desktop 托管模式；默认 OneBot 地址为
ws://127.0.0.1:3001。 - 设置 owner、管理员、白名单、默认权限和冷却时间，并将智能体绑定到目标群。
- 先用
qq_info验证目标，再发送测试文本。 - 文件、私聊、群管理和游戏转交操作必须经过明确授权；禁止把访问令牌写入示例或日志。
连接失败见 QQ 问题。