Go + gorilla/websocket · OneBot 11 全兼容

把 NapCat 装进浏览器, 让 QQ 机器人运营一体化。

单进程承载多账号实例,支持扫码与密码双登录、自动容器编排、反向 WebSocket 长连接监听, 并内置 OneBot 11 全量接口与事件文档,插件开发从申请到上线全程可控。

150接口条目
24事件类型
23消息段
1 : N容器复用策略
localhost:8080/console
猫
主号 · 运营机器人
QQ 10001 · napcat-10001-a7f2
在线
群
分号 · 客服助手
QQ 10002 · napcat-10002-c19d
待扫码
[群消息] 技术交流群 · 10086
张三 > 这个面板怎么接插件?
[已回复] 打开控制台 - 接口文档即可查看全部能力
Capabilities

一个面板,覆盖账号、容器、消息与插件全生命周期

后端以 Go 单二进制运行,前端为纯静态资源,零构建、零外部依赖,部署即用。

多账号实例管理

一个账号对应一个独立实例,端口、令牌与容器信息自动分配,支持启动、停止、重启与实时在线状态追踪。

自动容器编排

新增账号即拉起 NapCat Docker 容器,可配置「一号一容器」或「三号共容器」,端口自动避让,无需手工维护。

反向 WebSocket 长连接

NapCat 主动连入平台,心跳、事件与调用双向贯通;断线自动重连,并保留正向 WS 与 HTTP 上报作为兜底。

全量接口文档

内置 OneBot 11 全部接口、事件与消息段说明,前台表格即席检索、分类与分页浏览,插件开发无需翻文档。

插件开发者体系

用户在前台提交开发者申请与插件安装申请,管理员逐条审核;审核意见回传,权限边界清晰可控。

管理员后台

统一管理前台账号、实例、容器、插件与安装申请,配额、封禁、角色与审计日志一屏可见。

Workflow

三步完成从注册到机器人上线

平台负责容器与令牌的分发,你只需在 NapCat 侧填入一条反向 WebSocket 地址。

STEP 01

注册并等待审核

使用账号密码注册,管理员在后台确认后账号即转为可用状态,并分配实例配额。

STEP 02

创建 QQ 实例

填写 QQ 号并选择扫码或密码登录,系统自动创建容器、分配端口并生成专属接入令牌。

ws://你的域名/onebot/<实例 ID>?token=...
STEP 03

登录并开始收发

打开实例 WebUI 完成扫码或密码登录,消息事件即时推送至控制台,可直接调用任意 OneBot 接口。

Open API

OneBot 11 接口,表格化呈现

接口、事件与消息段三类文档均可检索与分页,插件开发者可在此基础上直接编排业务逻辑。

分类 动作名 名称 说明
消息 send_msg 发送消息 按消息类型自动路由到私聊或群聊,支持消息段数组。
群组 get_group_list 获取群列表 返回机器人已加入的群信息集合,含群名与成员数。
账号 get_login_info 获取登录号信息 返回当前登录账号的 QQ 号与昵称,用于健康检查。
文件 upload_group_file 上传群文件 上传本地文件到指定群,支持自定义文件夹与超时控制。
以上为节选,完整清单请进入控制台的「接口文档」查看。 查看全部接口

现在就把第一个机器人接上来

注册账号、创建实例、扫码登录,整个流程在同一个面板内完成,无需额外服务器或反向代理配置。