Skip to content

目录

字数
1110 字
阅读时间
5 分钟

接入适配器

温馨提示

支持所有符合 OneBot11 标准的平台 包括但不限于以下
以下排名不分先后 感谢所有前行者的无私奉献!

基本配置信息

温馨提示

本文适用于1.4.7+版本
启动 Karin 后,你将看到一个充满魔法的控制台界面 ✨

默认配置一览

  • HTTP 服务端口: 7777
  • WebSocket 服务端口: 7777 (与 HTTP 端口共用)
  • HTTP Token: 自动生成的 6 位随机大小写字母
  • WebSocket Token: 自动生成的 6 位随机大小写字母
  • Web 控制台地址: http://127.0.0.1:7777/web
  • OneBot11 API 接入点(任选其一):
    • 1: ws://127.0.0.1:7777
    • 2: ws://127.0.0.1:7777/onebot/v11/ws
    • 3: http_post http://127.0.0.1:7777/onebot

karin_start

WebSocket 连接说明

小贴士

让我们来了解一下 WebSocket 连接的两种模式,就像认识两个性格不同的小伙伴 🤝

正向 WebSocket vs 反向 WebSocket

想象一下两种不同的交友方式:

  • 反向 WebSocket (Client 模式)

    • 协议端主动出击,向 Karin 发起连接请求
    • Karin 作为 WebSocket 服务器(Server)静待连接
    • 就像是协议端主动来敲 Karin 的门
  • 正向 WebSocket (Server 模式)

    • Karin 主动出击,向协议端发起连接
    • 协议端作为 WebSocket 服务器等待连接
    • 就像是 Karin 去拜访协议端

Karin 默认开启反向 WebSocket 模式,也就是在家里等着朋友来访 🏠

实战配置:以 NapCat 为例

温馨提示

开始之前,请确保已从 Karin 控制台获取到 WebSocket 鉴权 Token

配置步骤

  1. 启动 Karin,它会在 7777 端口开启派对 🎉
  2. 从控制台获取专属的 WebSocket 鉴权 Token
  3. 启动 NapCat,建立友谊
  4. 配置 NapCat,让它知道去哪找 Karin
  5. 查看 Karin 日志,确认连接成功

NapCat 具体配置

首先确保你已经:

  • 安装好 NapCat
  • 进入 NapCat 的 Web 控制台

配置详细步骤

  1. NapCat 控制台点击网络配置

napcat_webui

  1. 创建新连接:
    • 点击新建按钮
    • 选择WebSocket客户端模式

napcat_webui_client_new

  1. 填写连接信息:
    • 启用开关:✅ 开启
    • 名称:karin (支持任意名称)
    • URL:ws://127.0.0.1:7777
    • 鉴权Token:填入 Karin 控制台显示的 Token
    • 最后点击保存

napcat_webui_client_save

如果一切顺利,切换到 Karin 控制台,你会看到这样温馨的提示:

karin_connect

恭喜你!Karin 和 NapCat 已经成功牵手啦 🎊

实战配置二: Karin 主动出击 NapCat

温馨提示

鉴权token支持不配置,但是推荐配置。

配置步骤

  1. 启动 NapCat 开启服务
  2. 配置 NapCat 开启端口
  3. 启动 karin
  4. 进入 Karin-webui 配置 WebSocket 连接
  5. 配置 WebSocket 连接信息
  6. 保存配置
  7. 查看 Karin 日志,确认连接成功

NapCat 具体配置

  1. NapCat 控制台点击网络配置

napcat_webui

  1. 创建新连接:
    • 点击新建按钮
    • 选择WebSocket服务器模式

napcat_webui_client_new

  1. 填写连接信息:
    • 启用开关:✅ 开启
    • 名称:karin_server (支持任意名称)
    • HOST: 无需修改 默认即可
    • Port: 3001 (记住此端口 后续需要使用)
    • Token: NapCat (不配置也可以的 如果配置需要记住 后续需要使用)
    • 最后点击保存

napcat_webui_client_save

  1. 组合wsUrl: ws://127.0.0.1:3001 token: NapCat

Karin 具体配置

  1. 打开 Karin-webui
    • 打开 http://127.0.0.1:7777/web 如果更换了端口请以控制台打印为准
    • 在登录页面输入控制台打印的 http鉴权token: AffryQ
    • 点击登录

karin_webui_login

  1. 进入 Karin-webui 配置 WebSocket 连接
    • 点击 配置信息 进入系统配置
    • 选择 适配器
    • 选择 正向 WebSocket 客户端
    • 点击 添加

karin_webui_client_new

  1. 填写连接信息:
    • 启用开关:✅ 开启
    • WebSocketServer 地址: ws://127.0.0.1:3001
    • Token: NapCat
    • 最后点击右上角的保存

karin_webui_websocket_save

  1. 查看 Karin 日志,确认连接成功

karin_connect

TIP

更多接入正在编写中...