QQ 智能体与权限
Alice 内置 QQ 模块，通过 NapCat/OneBot 11 WebSocket 接入账号。桌面托管是普通 Windows 用户的主路径；Docker 或手工 OneBot 连接属于高级部署方式。
支持状态：已支持
QQ 登录和群操作受 NapCat、OneBot 与 QQ 平台状态影响，请使用专用账号并遵守平台规则。
需求
完成 QQ 智能体需要：
- Alice 中至少一个可用模型和智能体；
- 在
机器人页面添加并登录一个 QQ 账号； - 设置账号默认权限、冷却时间和是否允许私聊；
- 将账号及目标群绑定到智能体；
- 群聊按需开启
仅 @ 触发。
纯 QQ 对话不要求 Minecraft 在线；需要查询或操作游戏时，绑定智能体所属工作区必须在线。
架构
QQ 账号负责 OneBot 连接、消息收发、群信息与权限；QQ 智能体拥有独立对话历史、人设和可用工具，并可通过内部请求把游戏操作转交主智能体。
账号级四级权限按数值从低到高：
| 等级 | 含义 | 建议用途 |
|---|---|---|
NONE | 无权限 | 拒绝机器人交互 |
BASIC | 基础 | 普通聊天和低风险查询 |
COMMAND | 命令 | 允许白名单用户发起受控命令 |
ADMIN | 管理员 | 高风险操作和群管理 |
群主/所有者和管理员列表会得到 ADMIN，白名单用户得到 COMMAND，其他用户使用默认权限。权限检查采用“用户等级不低于工具要求”的规则。群管理工具在执行前会再次要求 ADMIN；同时还必须满足机器人 QQ 账号在目标群中的实际权限。
当前账号权限 UI 主要设置默认等级、冷却时间和私聊开关。不要误以为只把默认权限设为
ADMIN就能绕过 QQ 群自身权限。
执行
添加账号
- 打开左侧
机器人。 - 使用应用内安装/账号向导选择桌面版 NapCat，并按提示登录。
- 等待账号状态变为在线。
- 在账号详情的权限页设置：
默认权限；- 同一用户两次命令的
冷却时间； 允许私聊；- NapCat
数据存储目录。
- 点击
保存权限配置。
高级用户可选择 Docker 容器或手工 WebSocket，但应先完成相应部署与鉴权。
绑定智能体
- 创建智能体时在第 4 步
机器人启用绑定，或打开现有智能体的QQ/配置。 - 选择在线账号和监听群组。
- 群消息只应在明确提及时触发，可开启
仅 @ 触发。 - 在 QQ 独立配置中按需设置
基本、定时、工具、技能、偏好和设定，然后保存。
验证
- 用具有预期权限的账号发送私聊，或在绑定群中 @ 机器人；
- 先发送普通问候，再发送只读查询；
- 在账号详情查看
消息记录；已绑定 Agent 时可查看LLM 对话； - 需要游戏操作时，确认主智能体和工作区均在线。
成功标志：账号在线，消息记录出现入站消息，QQ 智能体返回回复；游戏请求还能产生主智能体工具调用结果。
失败处理
- 消息被忽略：检查群是否在绑定列表、
仅 @ 触发和允许私聊； - 提示权限不足：核对默认等级、管理员/白名单来源及操作要求；
- 账号在线但 LLM 不回复：检查智能体绑定和 QQ 模型，QQ 模型未配置时会回退主模型；
- 游戏请求超时：恢复工作区和主智能体，QQ 对话与游戏执行是两条链路；
- 群管理失败：确认机器人账号本身是群管理员，并减少默认开放权限。