接入 QQ 群消息

使用托管 NapCat 或自建 OneBot WebSocket 接收 QQ 群消息。

配置步骤

1. 选择托管或自建 普通用户选择“托管 QQ”，由后台创建运行环境；已有 NapCat 的用户选择自建 OneBot。
2. 完成 QQ 登录 托管模式按页面提示扫码登录。自建模式需让 NapCat 提供正向 WebSocket 地址和访问令牌。
3. 填写来源群号 频道配置的来源类型选择“QQ群（OneBot）”，填写纯数字群号。
4. 按发送者过滤 如只转发特定成员，在高级规则的“允许用户 ID”填写 QQ 号，按回车生成标签。

字段怎么填

字段	示例	说明
连接方式	托管 QQ / 自建 OneBot	二选一，不要同时配置。
WebSocket URL	ws://127.0.0.1:3001	仅自建模式需要，地址必须能被运行节点访问。
访问令牌	NapCat 中设置的 Token	两端必须完全一致。
来源群号	123456789	只填数字，不填群名称。

安全提醒

• QQ 登录可能触发风控，请使用稳定网络和专用账号。

完成后验证

• [ ] QQ 来源状态为已连接
• [ ] 机器人账号已经加入来源群
• [ ] 群消息能出现在运行日志中