前言

你好吖~这边是搭建基于ZeroBot-Plugin项目的QQ机器人的详细指北

既然你搜索到了这个专栏 或许是想搭建一个很不错的机器人项目吧w

那好~咱们开始吧www

大致介绍

ZeroBot-Plugin 是基于 ZeroBot 的 OneBot 插件套组,提供了较丰富的插件(目前68个)

目前项目更新效率如高产母猪且高质量，是目前较活跃的qq机器人开发项目

目前项目地址:

https://github.com/FloatTech/ZeroBot-Plugin

为了方便 将ZeroBot-Plugin项目简称为zbp

功能一览

还有很多功能 各位可以在此查找

https://github.com/FloatTech/ZeroBot-Plugin

项目特性 vs 优势

1.更新活跃,star数增长快,项目潜力大:

2.基于 Go 语言的优势,项目支持二进制编译(无需搭建环境和相关需求包即可运行 点名Python和Java) 支持多平台(darwin(MacOS),linux,windows,配合termux可以部署到安卓机)

3.傻瓜式操作，提供打包好的 go-cqhttp+zerobot-plugin 整合运行包,做到三分钟内搭建完毕

4.良好的插件编写案例，即使是新手也很容易上手编写简单的插件

5.项目轻量，一个可执行文件不到30M

6.友好的交流环境，目前有zbp相关的交流群，群号: 1048452984 (欢迎前来划水)

为什么不是?

> 真寻: 基于nonebot项目，大部分相关的功能zbp也有。

且相对来说，真寻占用的内存更高(在Linux下可以占用1g左右,且需要很多python包和python的环境部署) | 对于postgresql数据库的搭建可能对新手不大友好

> mirai: 基于Java | 配置上相对于新手麻烦 |  插件查找需要花费一定的时间 | 需要一定的环境部署

快速上手

目前zbp提供了打包了go-cqhttp(无头qq)+zbp的整合包 快速搭建请下载这个:

https://github.com/FloatTech/gocqzbp/releases/

如果您发现访问不上 可以尝试

https://hub.fastgit.xyz/FloatTech/gocqzbp/releases/

1. 如果您是在家用电脑(Windows环境): windows_amd64
   

2. 如果您是 x64 Linux 平台 如各种云服务器: linux_amd64

3. 如果您是 armv6 Linux 平台 如树莓派 zero W: armv6

4. 如果您是 MacOS(Darwin平台) 可以使用: darwin

我们就以windows环境为例子搭建

ps: 如果你发现下载速率慢 可以试着复制链接后在github.com前面加上ghproxy.com/

使用反代加速下载

如果操作正常 您下载解压(选一个您觉得比较方便打开的位置)完是这样的:

如果你双击gocqzbp.exe打开的话 你会发现这个界面

确认即可,他会在当前目录自动生成一个bat快捷打开脚本,以后建议打开使用此bat 方便启用

如果您找不到后缀名的话,我建议您查看这个

https://jingyan.baidu.com/article/a3f121e400f505bd9052bbae.html

正常打开如图所示，输入2后确认关闭页面即可

如果正常操作，目前的文件夹是这个样子的

好的，我们现在打开config.yml

如果打不开可以使用记事本打开x

首先 我们先修改这两项:

可以设置成如下的:

好的，接下来我们修改这一项

将0.0.0.0:8080改为127.0.0.1:6700

修改好后保存即可

之后 我们需要在生成的bat下添加参数(go-cqhttp.bat)

右键编辑即可

本参数意味着 设置名字为Lucy 超管用户号为1292581422

举个例子:   "gocqzbp.exe" -n Lucy 1292581422

如果你在添加名字参数使用中文的时候出现了无法启动bat的现象

请在 start 前面打两个空格 [即按两次] 

在左上角文件点开 选择另存为

将其中那个UTF-8改为ANSI编码后保存覆盖运行即可

好的 你已经成功部署好了x 现在我们可以启动了

如果需要使用的话 请在需要工作的群发送 /响应

注意: 只有群主/群管理/超管 才可以使用此功能

提示如下，说明已经正常工作了x

如果需要单方面禁用某个群的使用 可以在群中发送 /沉默  即可

简单的zbp就已经搭建完成了x

完整功能请查看此页:

> https://github.com/FloatTech/ZeroBot-Plugin

参考此项目下的功能 在群中发送即可

如果需要在群中帮助的话 可以发送 /服务列表 查看所有插件

如果需要具体某个插件的帮助的话 可以使用 /用法 插件名 即可

至此 简单的zbp已经搭建成功了w

关于服务器端搭建(Centos)

我们这边就以centos为例 进行简单的搭建

首先我们需要一台服务器(x 这边可以使用基于Ubuntu/centos)

不过建议centos转到Ubuntu系统 因为Centos已经停止维护了 目前的yum源没法使用

首先先新建一个文件夹 转到这个文件夹目录下

我这边就以bot为名新建了一个文件夹

其次 我们需要在上述的releases页面找到Linux使用的版本

右击打开后复制链接即可

其次 我们回到命令行界面 输入

wget 你复制的链接

一般这样就是下载好了w 可以使用ls指令查看当前目录的情况

之后呢 我们需要使用 tar -zxvf 来解压这个压缩包

在文件那部分 可以使用tab进行补全文件名

解压后如下 这边可以查看文件的情况w

这样文件就已经处理好了w

其次呢 我们需要给执行文件一个权限 保证可以在Linux下运行

一般是 chmod 755 gocqzbp

这样文件就可以正常运行了x

输入 ./gocqzbp (同样可以使用tab进行补全)就可以运行了

和在Windows下的快速部署一致 输入2确认即可

通过ls指令查看 可以发现出现了config.yml配置文件

这时候我们就需要使用一个叫 vim 的编辑器 帮助我们配置文件

打开后可以发现和Windows一样的文件内容

这时候还是需要修改我们需要的东西

绿色部分即为我们的光标 在键盘上 按 i 可以进入编辑模式

依次修改 账户 密码 后将光标移动到最底下 

修改成如上即可后 按ESC退出编辑模式

后在键盘上以小写英文的方式 输入 :wq 即可退出保存 

打开时候 可以使用   ./gocqzbp -n 名字 超管号

进行打开操作 至此 我们已经完成了在CentOS上的搭建步骤

在Ubuntu上操作是一致的 没有什么区别

服务器上保留进程方案

啊咧....我把shell一关 我就不能继续用了x

可以通过进程守护工具或者screen来守护相关进程

blog.csdn.net/qq_37696855/article/details/122801754

Q&A

1. Q: 我的zbp出现了发送信息失败，出现了账户被风控的现象

A: 删掉session.token文件，给你的账户打开设备锁

打开后重新尝试，如果发现仍处于风控状态 建议挂3-7天

2.Q: 我配置的时候出现了 配置文件不合法

你可以删除config.yml后重新生成配置文件，这是因为配置原因导致的

3.Q: 我是在腾讯云服务器上部署的，提示我无法发送长信息

A：修改腾讯云的dns为114.114.114.114(提示 这样的话 可能内网的apt包更新会出错)

4.Q：无法连接上/发送相关指令没有响应

A：如果zbp没有出现报错

或许你需要确认下你是否为 超级用户 还有是否发送了 /响应  在当前群响应

如果出现报错 请检查网络问题(DNS配置)，是否被风控 按相对应的操作进行

5.Q: 我无法使用其中的 vtb语录 功能

A: 请安装ffmpeg

可以参考如下链接安装

https://docs.go-cqhttp.org/guide/quick_start.html#安装-ffmpeg

6.我生成的bat文件添加非英文名字后无法打开

请检查你是否修改了编码问题 并且在前面打了两个空格