Skip to content

接入框架

字数
988 字
阅读时间
4 分钟

NoneBot

  1. 配置 NoneBot

    这里假设你已经安装了 OneBot 适配器

    默认情况下,NoneBot 是启用了反向 ws 的,如果出现 403,可能是默认配置问题,需要配置 token 才能正常连接。

    具体方法为:修改 NoneBot 配置文件 .env,添加 ONEBOT_ACCESS_TOKEN=你在 NapCat 中配置的 token

    然后,启动 NoneBot,可以看到 NoneBot 输出的端口号,如 8080

  2. 配置 NapCat

    在 NapCat 配置添加反向 ws 地址,地址为 ws://127.0.0.1:8080/onebot/v11/ws, 这里的 8080 是 NoneBot 输出的端口号,/onebot/v11/ws 是 NoneBot onebot 适配器默认的路径

Koishi

  1. 在 Koishi 插件市场搜索 onebot 并安装 adapter-onebot,如下图:

    koishi-install-onebot

  2. 安装完之后,点击修改→配置

    koishi-onebot-go-setting

  3. 配置 OneBot

    这里以 WS 反向连接为例:

    • selfId 为你的机器人的 QQ 号
    • token 需和 NapCat 配置的 token 一致,当然,如果没有配置 token,则留空。
    • protocol 选择 ws-reverse

    其他配置保持默认即可,点击保存,然后启用插件。

    koishi-onebot-setting

    配置完成后,在 NapCat 的配置中添加 WS 反向地址。Koishi OneBot 的 ws 反向地址为 ws://127.0.0.1:5140/onebot。添加完成后,点击保存即可。

AstrBot

  1. 配置AstrBot

    选择 配置→消息平台→消息平台适配器→aiocqhttp(qq),默认即可,可根据需要更改。

    AstrBot-onebot-1

  2. 配置OneBot

    在 NapCat WebUI页面选择 网络配置→新建→WebSocket客户端,URL填入ws://127.0.0.1:6199/ws,添加完成后,点击保存即可。 AstrBot-onebot-2

OlivOS

支持正向和反向ws以及http详见 文档

onebotv11_rs

支持正向和反向ws以及http

node-napcat-ts

  1. 配置 NapCat

    在 NapCat 配置启用正向 ws

  2. 配置 node-napcat-ts

    详见 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继续使用。

  1. 配置 NapCat

    按照 NapCat 相关文档下载并部署 NapCat ,启动NapCat(推荐使用控制台启动)并扫码登录Bot,打开控制台输出的WebUI网址,使用默认token登录WebUI并配置和启用ws(推荐将NapCat作为服务器端)。

  2. 配置 Overflow

    详见 Overflow 文档

    根据文档指引安装Overflow,将在NapCat的WebUI中配置的ws相关信息填写到overflow.json中(推荐使用正向ws,将Overflow当作是客户端),注意信息填写一致。

  3. 移动 Mirai 相关文件

    将原先 MCL 中的插件(plugins)、数据(data)和配置(config)文件夹下相关文件移动至 Overflow 对应文件夹下。

    由于登录将由NapCat负责,与登录相关的文件无需移动,例如:AutoLogin.yml、mirai-device-generator.jar、fix-protocol-version.jar等。

  4. 都配置并移动好后,启动NapCat登录Bot,再启动Overflow,即可恢复Mirai插件的运行,替代原来MCL+签名服务的方式。

NcatBot

基于 NapCat 的 QQ 机器人 Python SDK,快速开发,轻松部署。

使用 Python 编程,对新手十分友好,对老手十分高效。

已完全对接 NapCat,提供一键安装并配置 NapCat 功能(Windows、Linux)

项目发布至 PyPI,可通过 pip install ncatbot 直接安装。

请参考使用文档 NcatBotDocs