MaiBot 文档中心

简体中文

English

简体中文

English

Appearance

安装和配置适配器 ​

要让 MaiBot 连接到 QQ、Telegram、微信、Discord 等消息平台，需要先安装对应平台的适配器。适配器会负责接收平台消息，再把消息交给 MaiBot 处理。

1. 选择适配器 ​

先根据你要接入的平台选择适配器：

适配器支持平台建议
NapCatQQ第一次部署 QQ 时优先选择，推荐插件版。
GoCQQQ旧方案，适合已有 GoCQ 环境或特定需求。
Snowluma（建设中）QQ仍在建设中，暂不建议新手作为首选。
TelegramTelegram社区适配器，使用前先查看仓库说明。
DiscordDiscord社区适配器，使用前先查看仓库说明。
更多适配器微信等可在 适配器概览 中查看。

第一次部署 QQ 平台时，建议使用 NapCat 插件版。它直接作为 MaiBot 插件运行，配置更少，也不需要额外维护适配器与 MaiBot 之间的网络连接。

2. 安装适配器 ​

不同适配器的安装方式不同，请优先参考对应适配器文档或仓库 README：

注意兼容性

部分社区适配器可能是旧版项目，未必兼容当前 MaiBot。安装前建议先查看仓库更新时间、README 和 Issue。

插件版适配器 ​

如果适配器提供插件版，通常按这个流程安装：

  1. 下载或克隆适配器项目。
  2. 确认切换到适配器要求的插件分支。
  3. 将适配器目录放入 MaiBot 的 plugins/ 目录。
  4. 启动 MaiBot，让插件系统自动加载适配器。

插件版适配器运行在 MaiBot 内部，通常只需要配置“消息平台到适配器”的连接。

独立版适配器 ​

如果适配器是独立版，通常按这个流程安装：

  1. 下载或克隆适配器项目。
  2. 按适配器文档安装依赖。
  3. 填写适配器自己的配置文件。
  4. 单独启动适配器进程。

独立版适配器需要同时连接消息平台和 MaiBot，排查问题时也要分别检查这两段连接。

3. 配置连接 ​

适配器通常需要配置两类连接：

连接方向说明
消息平台 → 适配器例如 NapCat 连接到 QQ，并把 QQ 消息推送给适配器。
适配器 → MaiBot独立版适配器需要连接 MaiBot；插件版适配器通常不需要额外配置这一层。

使用插件版适配器时，主要确认适配器能正确连接消息平台。

使用独立版适配器时，还需要确认适配器能连接到 MaiBot 的消息服务地址。

如果你不确定该填什么地址，先按对应适配器文档的默认本机配置来跑通，再考虑跨机器或 Docker 网络部署。

4. 确认连接成功 ​

配置完成后，向对应平台发送一条测试消息。

如果 MaiBot 后台能看到对应消息日志，并且 MaiBot 能正常回复，说明适配器已经连接成功。

如果没有收到消息，按这个顺序检查：

  1. 消息平台客户端是否已经登录成功。
  2. 适配器是否正常启动。
  3. 适配器是否成功连接消息平台。
  4. 独立版适配器是否成功连接 MaiBot。
  5. MaiBot 是否已经完成初始化并正常运行。

下一步 ​

适配器连通后，就可以继续配置 AI 模型和 MaiBot 设置：