QQ 来源用于监听指定群的新消息和撤回事件。请准备本人管理的 QQ 账号，确保账号已加入需要监听的群，并阅读页面中的非官方客户端风险提示。
方式一：节点托管扫码登录
选择 QQ 群来源，保留节点托管 NapCat，阅读提示后添加来源。
- 进入实例的“来源账号 → 添加来源”，选择 QQ 来源。
- 开启“由 ChannelFlow 节点托管 NapCat”，确认页面提示后创建来源。
- 在该来源的“扫码登录 / 查看登录”入口检查状态；也可回到实例设置查看登录状态。
- 状态为“NapCat 启动中”时等待节点准备；出现二维码后，使用对应手机 QQ 扫码，并完成手机端确认。
- 确认页面显示“QQ 已登录”。二维码过期时刷新二维码。
扫码动作本身不等于登录完成。不要反复删除来源或创建新的登录容器来重试。
方式二：连接已有 OneBot 服务
已有自己管理的 OneBot 服务时，关闭托管方式，在页面填写 OneBot WebSocket 地址与访问令牌。当前来源要求公网 wss:// 地址；内网地址、普通网页链接和目标投递使用的 HTTP 地址不能代替它。
配置完成后检查来源连接。服务部署或网络不清楚时，请让 OneBot 维护人员协助核对实际端点。
创建群转发规则
- 打开“频道配置 → 新建规则”，选择刚添加的 QQ 来源。
- “来源频道”填写来源 QQ 群号，格式为 5–15 位正整数。
- 不填写群昵称、群邀请链接、个人 QQ 号或带负号的 Telegram Chat ID。
- 选择投递目标类型，填写其参数并保存。
- 启动实例，在“运行日志”确认来源已连接且规则已加载。
仅转发指定成员时，可在规则“允许用户 ID”填写对方 QQ 号，每行一个。第一次联调先不限制成员。
验证方法
请群内另一位有权成员发送一条新的普通文字消息，在“投递记录”和目标端核对。登录 QQ 自己发出的消息是否接收，由来源运行设置中的“接收自身消息”控制；关闭时不要用自己的发言判断转发失败。
常见问题
- “QQ 已登录”但来源未连接：登录和监听是两个状态，继续查看运行日志。
- 只有部分人的消息不转发：检查允许用户 ID、发送人黑名单和昵称屏蔽词。
- 没有补发旧消息：QQ 来源不读取历史记录，测试应在连接完成后进行。
- 消息来回重复：检查目标群是否又被配置成来源，及是否接收自身消息。
“QQ群（OneBot）”投递目标与 QQ 来源配置不同：目标使用公网 HTTPS OneBot HTTP 地址、访问令牌和目标群号。不要把来源的 WSS 地址填写到投递目标中。