Go + gorilla/websocket · OneBot 11 全兼容
把 NapCat 装进浏览器, 让 QQ 机器人运营一体化。
单进程承载多账号实例,支持扫码与密码双登录、自动容器编排、反向 WebSocket 长连接监听, 并内置 OneBot 11 全量接口与事件文档,插件开发从申请到上线全程可控。
猫
在线
主号 · 运营机器人
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 | 上传群文件 | 上传本地文件到指定群,支持自定义文件夹与超时控制。 |
以上为节选,完整清单请进入控制台的「接口文档」查看。
查看全部接口
现在就把第一个机器人接上来
注册账号、创建实例、扫码登录,整个流程在同一个面板内完成,无需额外服务器或反向代理配置。