萌卡 OB

面向 QQ 官方机器人的自托管框架。使用开放平台的 AppID 与 AppSecret，在一个控制台管理多个 Bot、连接状态、插件和运行日志。

当前状态

萌卡 OB 处于开发预览阶段，尚未发布正式发行包，真实机器人生产收发仍需进一步验收。

选择消息接入方式

WebSocket

框架主动连接 QQ 官方网关，处理连接、心跳、事件接收与重连。适合不方便提供公网 HTTPS 回调地址的环境。

Webhook

QQ 官方平台通过 HTTPS 将事件推送到框架。需要可访问的 HTTPS 地址，回调路径在机器人配置中显示。框架负责验证回调签名并接收事件。

每个 Bot 可独立选择接入方式，具体可用场景以该机器人在开放平台获得的权限为准。

在控制台中管理

• 添加与管理多个 Bot，每个 Bot 的凭据、连接和插件设置相互独立。
• 配置代理节点，查看事件记录、发送结果和运行日志。
• 使用接口调试验证官方消息调用。
• 通过正向 WebSocket、反向 WebSocket或本机 IPC 接入插件。
• 设置本地管理员、站点外观和邮件通知。

插件服务界面预览，图中使用本地演示配置。

从这里开始

1. 部署与初始化：准备机器人凭据，了解启动和接入流程。
2. 官方接口调试：查看参数、请求示例和返回结果。
3. 插件服务与导入：连接插件或导入可信插件包。
4. 插件协议与包规范：按 obp/1 编写自己的插件。

OB 不使用 QQ 账号密码、设备指纹或 NT 等级任务。已有 NT、OneBot 或其他框架插件需要按 OB 协议适配。