WanQ（旺Q）QQ官方机器人
WanQ（旺Q）是基于 QQ 开放平台官方机器人 API 的独立服务端应用，支持 Docker 部署，自带 Web 管理界面。
💬 与 LLOneBot 的区别
WanQ 使用QQ官方API（合规合法），需独立部署；LLOneBot 基于 OneBot 协议（功能更全面），作为插件运行。两者可以二选一，根据需求选用。
与 LLOneBot 的对比
| 对比项 | WanQ（旺Q） | LLOneBot |
|---|---|---|
| 协议 | QQ官方机器人API | OneBot v11 协议 |
| 合规性 | 官方授权，合规合法 | 非官方协议 |
| 部署方式 | 独立服务端 + Docker | 插件（依赖外部框架） |
| 管理界面 | 内置Web管理（端口5000） | 无 |
| 用户标识 | openid（非真实QQ号） | 真实QQ号 |
| 消息能力 | 文本/图片/视频/语音/文件/分享链接 | 更丰富（表情/小程序等） |
| 群管理 | 不支持 | 支持 |
| 朋友圈 | 不支持 | 支持 |
部署方式
Docker 部署（推荐）
bash
docker run -d -p 5000:5000 \
--name wanq \
--hostname wanq \
--restart unless-stopped \
-v $PWD/wanqdata:/app/data \
crpi-5mft5k2asrq5fkut.cn-hangzhou.personal.cr.aliyuncs.com/zhaoyangguang/wanq:latest| 配置项 | 值 |
|---|---|
| 服务端口 | 5000 |
| 数据库 | SQLite（/app/data/WanQ.db） |
| 时区 | Asia/Shanghai |
| 数据卷 | /app/data（数据库）、/app/wwwroot/images（图片临时文件） |
手动部署
- 获取 WanQ 发布包
- 解压到服务器目录
- 运行
WanQ.Server - 浏览器访问
http://服务器IP:5000
配置指南
第一步：登录旺财狗账号
首次访问 WanQ 管理界面时，需要使用旺财狗账号登录。
- 登录地址会自动指向旺财狗官方验证接口
- 软件ID为 34（旺Q对应的软件ID）
- 登录信息存储在本地 SQLite 数据库中
第二步：配置机器人
在「机器人配置」页面填写 QQ 开放平台的信息：
| 配置项 | 说明 |
|---|---|
| AppId | QQ开放平台机器人 AppId |
| AppSecret | QQ开放平台机器人 AppSecret |
| Token | WanQ API 鉴权 Token（自定义，用于插件调用验证） |
| ServerUrl | HTTP 回调地址（可选） |
⚠️ 前置条件
需要先在 QQ开放平台 注册机器人，获取 AppId 和 AppSecret。
第三步：配置回调
在「回调配置」页面填写旺财狗的连接信息：
| 配置项 | 说明 |
|---|---|
| 回调地址 | 旺财狗 WebSocket 地址（ws:// 或 wss:// 开头） |
| 屏蔽群消息 | 是否屏蔽群消息转发 |
| 屏蔽私聊消息 | 是否屏蔽私聊消息转发 |
第四步：启动机器人
配置完成后，在首页点击启动开关。当 AppId 和 AppSecret 已配置时，机器人会自动启动。
第五步：旺财狗侧配置
在旺财狗管理界面中安装 RebateDog.Plugin.WanQ 插件，并配置机器人：
| 配置项 | 说明 |
|---|---|
| HTTP API地址 | WanQ 服务地址，如 http://xxx:5000 |
| Token | 与 WanQ「机器人配置」中的 Token 一致 |
| 机器人ID | QQ AppId |
| 使用WebSocket | 是否启用 WebSocket 发送模式 |
支持的消息类型
接收消息（QQ → 旺财狗）
| 类型 | 支持 |
|---|---|
| 文本 | 支持 |
| 图片 | 支持 |
| 群@消息 | 支持 |
| 群全量消息 | 支持（需官方权限） |
| 私聊消息 | 支持 |
发送消息（旺财狗 → QQ）
| 类型 | 支持 |
|---|---|
| 文本 | 支持 |
| 图片 | 支持 |
| 混合消息（文本+图片） | 支持 |
| 分享链接 | 支持 |
| 视频 | 支持 |
| 文件 | 支持 |
| 语音 | 支持 |
💡 HTTP API 鉴权
WanQ 的发送接口使用 X-WanQ-TOKEN 请求头进行鉴权，Token 为 WanQ「机器人配置」中设置的值。未设置 Token 时不验证。
⚠️ 注意事项
- QQ官方API使用 openid 标识用户，非真实QQ号
- 群消息需要@机器人才会收到（除非有全量消息权限）
- 被动回复使用 msg_id 关联，5分钟内有效
- QQ官方API不支持朋友圈、好友列表、群管理等功能