接入框架
NoneBot
配置 NoneBot
这里假设你已经安装了 OneBot 适配器
默认情况下,NoneBot 是启用了反向 ws 的,如果出现 403,可能是默认配置问题,需要配置
token
才能正常连接。具体方法为:修改 NoneBot 配置文件
.env
,添加ONEBOT_ACCESS_TOKEN=你在 NapCat 中配置的 token
。然后,启动 NoneBot,可以看到 NoneBot 输出的端口号,如
8080
。配置 NapCat
在 NapCat 配置添加反向 ws 地址,地址为
ws://127.0.0.1:8080/onebot/v11/ws
, 这里的8080
是 NoneBot 输出的端口号,/onebot/v11/ws
是 NoneBot onebot 适配器默认的路径
Koishi
在 Koishi 插件市场搜索
onebot
并安装adapter-onebot
,如下图:安装完之后,点击修改→配置
配置 OneBot
这里以 WS 反向连接为例:
selfId
为你的机器人的 QQ 号token
需和 NapCat 配置的token
一致,当然,如果没有配置 token,则留空。protocol
选择 ws-reverse
其他配置保持默认即可,点击保存,然后启用插件。
配置完成后,在 NapCat 的配置中添加 WS 反向地址。Koishi OneBot 的 ws 反向地址为
ws://127.0.0.1:5140/onebot
。添加完成后,点击保存即可。
AstrBot
配置AstrBot
选择 配置→消息平台→消息平台适配器→aiocqhttp(qq),默认即可,可根据需要更改。
配置OneBot
在 NapCat WebUI页面选择 网络配置→新建→WebSocket客户端,URL填入
ws://127.0.0.1:6199/ws
,添加完成后,点击保存即可。
OlivOS
支持正向和反向ws以及http详见 文档
onebotv11_rs
支持正向和反向ws以及http
node-napcat-ts
配置 NapCat
在 NapCat 配置启用正向 ws
配置 node-napcat-ts
如果出现连接失败,可能是配置问题,需要配置 token 才能正常连接。
Minato
基于 node-napcat-ts
实现的,所以需要的配置类似
只需要配置几个插件 /src/plugins
即可运行, 配置方法: 复制 config.default.ts
文件到 config.ts
并配置其中配置项即可运行
Kovi
Rust Onebot V11 插件框架。
将 NapCat 配置启用正向ws。
编写插件或使用社区插件,编译启动即可。(文档里面非常详细哦)
编写插件可使用 NapCat Api 拓展 。
Mirai
可通过Overflow对接Mirai框架,以快速方便的实现Mirai插件从MCL启动方式无缝切换到NapCat继续使用。
配置 NapCat
按照 NapCat 相关文档下载并部署 NapCat ,启动NapCat(推荐使用控制台启动)并扫码登录Bot,打开控制台输出的WebUI网址,使用默认token登录WebUI并配置和启用ws(推荐将NapCat作为服务器端)。
配置 Overflow
根据文档指引安装Overflow,将在NapCat的WebUI中配置的ws相关信息填写到overflow.json中(推荐使用正向ws,将Overflow当作是客户端),注意信息填写一致。
移动 Mirai 相关文件
将原先 MCL 中的插件(plugins)、数据(data)和配置(config)文件夹下相关文件移动至 Overflow 对应文件夹下。
由于登录将由NapCat负责,与登录相关的文件无需移动,例如:AutoLogin.yml、mirai-device-generator.jar、fix-protocol-version.jar等。
都配置并移动好后,启动NapCat登录Bot,再启动Overflow,即可恢复Mirai插件的运行,替代原来MCL+签名服务的方式。
NcatBot
基于 NapCat 的 QQ 机器人 Python SDK,快速开发,轻松部署。
使用 Python 编程,对新手十分友好,对老手十分高效。
已完全对接 NapCat,提供一键安装并配置 NapCat 功能(Windows、Linux)
项目发布至 PyPI,可通过 pip install ncatbot
直接安装。
请参考使用文档 NcatBotDocs