QQ 机器人

把 QQ 群聊或单聊连接到已有工作区对话，在 QQ 中发送任务、追加要求、停止任务，以及回应审批和问题。完整结果可在面板查看。

准备机器人

1. 在 QQ 开放平台创建官方机器人，取得 AppID 和 AppSecret，开通所需群聊、单聊和按钮互动能力。
2. 在 GameX 安装并启用插件，设置账号和工作区使用范围。插件支持 Linux amd64/arm64，需要支持外部对话事件的面板。
3. 在插件配置填写 QQ AppID，将 AppSecret 保存到专用 QQ AppSecret 密钥栏，不要发送到对话中。
4. 选择连接方式，并在目标工作区准备一个可用对话。

连接方式	要求
WebSocket（默认）	面板能访问 QQ 的 HTTPS/WSS 接口，无需公网回调地址
Webhook	面板可通过公网 HTTPS 访问；在工作区 QQ 机器人 → 接入设置 复制回调地址，填写到 QQ 开放平台

事件权限对应 GROUP_AT_MESSAGE_CREATE、C2C_MESSAGE_CREATE、INTERACTION_CREATE。两种方式均由后台接收消息，无需保持浏览器打开。

Webhook 反向代理需保留原始请求体和签名头，详见回调校验。接入资料：WebSocket、官方 SDK。

绑定聊天

1. 打开目标工作区 QQ 机器人 视图，新增绑定。
2. 选择群聊或单聊、目标对话和处理方式，生成绑定指令。
3. 在目标群 @机器人 发送指令，或向机器人单聊发送。
4. 返回面板核对来源聊天、发言人和目标对话，再确认绑定。指令十分钟内有效，取消后作废。

QQ 任务使用绑定账号的面板身份。 确认该对话内容可以分享给目标聊天。群聊不会自动授权所有成员：在 成员管理 生成加入指令，让成员发送，再由绑定人确认。

新成员默认只读，绑定人可在 成员管理 中调整成员角色。

绑定任务还可能读取绑定人的个人记忆。用于群聊时，请使用专门账号，并先清除不应分享的个人记忆。

仅绑定人可修改、暂停或解除自己的绑定，以及管理成员。昵称和群名仅供显示，不用于授权。

选择处理方式

设置	可选行为
回复内容	简洁摘要（默认），或包含可见中途回复的详细过程
操作审批	手动审批、替我审批（默认）、完全访问权限；必要人工确认仍会保留
对话忙碌时	引导（默认）：追加到当前任务；排队：作为后续任务

审批模型不可用时，新绑定默认手动审批。QQ 使用绑定自己的审批设置，已有绑定不会随默认值变化。可在绑定设置中调整，也可关闭 启用绑定 暂停新任务。

主动推送默认关闭。开启后，面板中新增的文字消息、AI 回复、审批和问题也会同步到绑定聊天。面板发起的审批和问题仅绑定人可回答，暂停绑定后停止推送。

在 QQ 中使用

群消息需要 @机器人，单聊直接发送。

• 发文字或图片：提交任务；任务进行中按设置追加要求或排队。
• 收到审批：点击 批准 或 拒绝。
• 收到问题：点击选项，或回复字母、选项内容或自己的答案。
• 需要中止：点击 停止任务。已开始操作的实际结果以面板为准。

按钮无需额外 @机器人。审批和问题只接受绑定人或对应请求发起人的有效回复，需要强验证的操作仍须回到面板。也可发送 批准 <请求ID>、拒绝 <请求ID>、停止 <任务ID>，将占位内容替换为当前消息中的 ID。

每条消息最多八张 PNG、JPEG、GIF 或 WebP 图片，单张大小受面板限制。模型是否能理解图片，取决于当前模型能力。

查看结果和排查

打开 历史记录 查看任务、来源、发起人及消息发送状态；完整输出在绑定的面板对话中。已发送 表示 QQ 平台已接受消息，不代表用户已经阅读。

回复优先使用原消息的被动回复机会。超时、次数用尽或 QQ 明确拒绝被动回复后，会尝试主动推送；仍受 QQ 权限、接收设置和频控限制。结果未知时不会盲目切换方式或重复发送，通知失败也不会重新执行任务。

• 消息没有触发任务：检查 @、已确认且启用的绑定、成员授权和事件权限。
• 绑定失败：检查指令是否过期或取消，重新生成后核对来源。
• 任务完成但没有回复：先查看面板对话和历史记录，确认实际结果后再决定是否重试。

停用插件会断开后台连接；卸载会删除插件持久数据。