纯 QQ 快速开始
适用对象
不连接 Minecraft，只希望让 Alice 智能体通过 QQ 私聊或群聊响应消息的 Windows 用户或群管理员。
支持状态与验证版本
- 已支持：Alice 内置 QQ 模块通过 NapCat / OneBot WebSocket 接入。
- 默认路径是应用内 桌面版 NapCat 安装与账号向导，无需 Docker。
- Docker 与外部 OneBot 连接属于高级部署方式，不是本页主路径。
前置条件
- 已安装并启动 Alice Windows 桌面应用。
- 已准备可用的大语言模型 API，并理解密钥应只保存在 Alice 中。
- 已准备一个用于机器人的 QQ 账号；建议不要使用无法承受风控或封禁的主账号。
- 能在需要接入的群中配置机器人权限和使用范围。
步骤
- 在 Alice 左侧进入“模型”，点击“添加模型”，填写服务商、模型名称和凭据后执行“测试连接”。
- 点击“创建智能体”，为智能体选择已测试的模型；如向导提供“QQ 机器人模型”，选择合适模型或沿用主模型，完成创建。
- 进入 QQ/机器人页面。首次进入时，Alice 会显示 NapCat 安装向导。
- 选择“桌面版 NapCat”，优先使用“自动安装”；如自动安装失败，再下载 NapCat 并用“手动安装”选择、验证解压目录。
- 按账号向导启动 NapCat，扫描二维码或完成账号登录，等待 Alice 显示账号在线。
- 将 QQ 账号绑定到刚创建的智能体，并配置允许的私聊、群聊和触发规则。群聊按界面要求设置是否需要 @。
- 从一个被允许的私聊或群聊发送测试消息，例如“你好，请回复当前连接状态”。
成功标志
- 模型连接测试成功。
- 桌面版 NapCat 安装验证通过，Alice 可以托管其进程。
- QQ 账号在 Alice 中显示在线，并已绑定到目标智能体。
- 允许范围内的私聊或群聊消息得到回复。
常见失败
- NapCat 自动安装失败：切换到向导内“手动安装”，解压 NapCat Windows 安装包后选择包含
package.json和启动文件的目录进行验证。 - 二维码不出现或登录超时：停止后重新启动账号向导，确认本机网络正常，并查看 NapCat 状态与日志。
- 账号在线但不回复：检查账号与智能体绑定、QQ 机器人模型、私聊/群聊权限、白名单和 @ 规则。
- 模型报错：回到“模型”页面重新测试地址、密钥和模型名称；不要把密钥发送到 QQ 群或问题截图中。
- 账号出现风控提示：立即停止自动化操作并按 QQ 提示处理；NapCat 属于第三方协议接入，无法消除平台风控风险。
下一步
- 使用 安装验证 检查完整消息链路。
- 需要连接 Minecraft 时，返回 认识 Alice 与选择使用方式 选择 Java 或 Bedrock 路径。