插件类型的机器人框架对接

💬 重要提示

旺财狗不锁死任何一款机器人——官方接口优先，几十款框架即插即换，生意不断线。

拿到一个机器人插件，大概率就是按本文的方式对接。这一篇是所有插件型框架的通用底座，读会一篇，几十款框架都会接。

0 先选对接方式（强烈推荐云中继）

对接插件机器人有两种方式，二选一：

方式	适合谁	难度
云中继（推荐）	不想折腾 IP、端口、地址这类东西，一键搞定	极低
本机直连（本文第 3~4 步）	旺财狗和机器人装在同一台电脑 / 服务器	中等

云中继是旺财狗官方提供的中转服务：你在旺财狗里点一下「生成对接码」，把码填到机器人框架里，两边自动连上，什么都不用配。具体步骤看 云中继对接教程。

下面是「本机直连」（老方式）的完整流程，两种方式选一种就行。

1 插件的获取

进入旺财狗「插件管理 → 插件市场」，按分类找到目标插件：

2 插件的安装

点击下载，就会自动下载并安装对应的插件了。

回到旺财狗的插件列表中，找到添加的插件，点击“启用”即可！

3 创建插件机器人

进入旺财狗「对接配置 → 聊天软件对接」，新增一个插件模式的机器人：

4 机器人回调消息到插件

机器人侧需要输入旺财狗提供给插件的消息回调地址，把这个地址输入到机器人的消息通知回调地址栏里面（都会有）。

这样子机器人框架会把收到的消息转发给旺财狗，旺财狗根据请求网址的参数，把消息交给对应的插件处理，处理完的消息统一交回旺财狗。

如图：

💬 重要提示

针对某个插件，一般还有专属教程：看浏览器左侧目录中当前插件目录下的专属对接文章。

💬 概括总结

1. 安装插件并启用

2. 创建插件类型的机器人

3. 输入机器人框架的远程调用地址（http）

4. 创建插件的消息接收地址（回调地址）

5. 将创建的回调地址输入到机器人框架

6. 完成对接

7. 一般插件的说明中会有更详细的教程。

5 选插件时的小标签（不用你管）

在旺财狗里选择插件时，插件自己会带几个「小标签」，用来告诉旺财狗该怎么连、该自动帮你填什么。这些你都不用手动改，旺财狗会自动处理：

小标签	大白话意思
必须 WS	这个插件只能走「长连接」跟机器人说话，选它时旺财狗会自动把开关打开
默认地址	选这个插件时，机器人的地址栏会自动帮你填好，不用手输
需要打包转发	像 TauBot 这类「壳 + 核心」分开装的框架才需要，选它时旺财狗自动开启
最低版本	如果插件要求更新的旺财狗，插件市场会弹窗提醒你「先升级旺财狗」，避免装了用不了

简单说：选好插件，剩下的交给旺财狗。