配置连接

连接功能是 Serein 的核心功能之一，它允许 Serein 与聊天平台的机器人应用进行通信。通过连接，Serein 可以接收来自聊天平台的消息，并将其转发到相应的插件或处理逻辑中。同时，Serein 也可以向聊天平台发送消息

Serein 目前支持OneBot 协议（V11、V12）和 Satori 协议

0. 这是什么

OneBot

一个聊天机器人应用接口标准，旨在统一不同聊天平台上的机器人应用开发接口，使开发者只需编写一次业务逻辑代码即可应用到多种机器人平台

—— 介绍 | OneBot

Satori

Satori 是一个通用的聊天协议。我们希望 Satori 能够抹平不同聊天平台之间的差异，让开发者以更低的成本开发出跨平台、可扩展、高性能的聊天应用。

经过长达 4 年的发展，Satori 有了健全的设计和完善的实现。目前，Satori 官方提供了超过 15 个聊天平台的适配器，完全覆盖了世界上主流的聊天平台

—— 介绍 | Satori

---

1. 选择一个客户端

备注

旧称 机器人框架 或 机器人

OneBot 实现

• NapCatQQ 👍推荐
• Lagrange.Core 👍推荐
• LLOneBot
• OpenShamrock

除此之外，你可以在生态 | OneBot找到更多 OneBot 实现

Satori SDK

• Koishi 👍推荐
• chronocat

---

2. 配置

OneBot

按照所选实现的文档或教程配置好 OneBot 协议，接着在 设置>连接>通用>适配器 中选择 正向WebSocket 或 反向WebSocket

正向WebSocket

OneBot 实现 启动时会根据配置文件指定的 IP 和端口开启一个 WebSocket 服务器，供 Serein 连接

反向WebSocket

Serein 开启一个 WebSocket 服务器，供 OneBot实现 连接，多用于需要同时使用多个 OneBot实现 的情况

注意

当你的 OneBot 实现 和 Serein 不在同一个设备上时需要将 WebSocket 服务器开放至公网，此时建议设置鉴权凭证

Satori SDK

按照所选实现的文档或教程配置好 Satori 协议，接着在 设置>连接>通用>适配器 中选择 Satori

除此之外你还需要在 设置>连接>通用>默认发送者 中填写当前的发送者信息，Satori 协议需要该信息来发送消息

---

3. 连接

Serein.Lite

在顶部菜单栏选择功能>连接，点击页面左侧的连接按钮

Serein.Plus

在左侧菜单栏选择连接，点击页面左侧的连接按钮

Serein.Cli

在控制台输入

connection open

---

如果一切顺利的话，这个时候你在群聊发送一条消息，接着就可以在控制台看到相应的输出了:D