适用小白的快速搭建QQ机器人的超详细教程(带马娘插件)08-03更新

2022年03月05日 4.1k 字大概 18 分钟阅读数次

适用小白的快速搭建一个QQ机器人(带马娘插件)

搭建教程（仅有windows server系统的教程）

需要准备的东西：

一台windows server服务器，腾讯云新用户40块钱一年，非常划算

一双手

一双眼睛

一台会自己百度解决问题的电脑（

有问题可前往该链接提问和讨论

有相关问题可以前往插件仓库的 Discussions 进行讨论

正式教程（本教程仅适用windows server）

step 1 买服务器

新用户40一年，腾讯的服务器是真的便宜，毕竟获取你的用户隐私数据他血赚，其实2核1G就够用，配置甚至可以更低一点，你也可以等618应该更便宜，到时候预计30左右一年

其他小家的服务器不建议买，万一出事了还得你自己承受，大厂里最便宜的就他准没错：

腾讯云秒杀链接（每天都有两轮，不怕买不到）：https://cloud.tencent.com/act/2022season?from=16224

买完装系统设置密码，1核2G服务器就选 win server 2012，2核4G及以上就选 win server 2016

设置账户账户名就默认的Administrator，密码你自己设一个有大写有小写有数字的密码就行

然后他就会开始自动装系统，可以稍微等一会，当实例状态显示：运行中就说明装好了，进入下一步

step 2 为你的服务器开启安全组和防火墙

打开你刚买的云服务器控制台，并到防火墙这里点击“添加规则”
2.1

然后端口选2333，协议选TCP即可点确定
2.2

欸，先别急着关网页，你看看刚才那个“添加规则”按钮上方往右一点是不是有个“（公）”字样，然后右边还有个IP地址，这窜IP地址就是您的公网IP，先记下来，待会有用

现在就可以关闭网页了

step 3 下载需要的六样东西

1. 下载gocqhttp:

原版下载链接：https://github.com/Mrs4s/go-cqhttp/releases
(下载go-cqhttp_windows_386.exe即可，但是原版未配置端口和反向ws代理设置)

所以我提供了配置好的下载链接（已经配置好端口和反向ws代理设置，版本是RC3）：https://cloud.594594.xyz/uma_bot/go_cqhttp.zip

更新Go-cq的时候你可以先复制备份一下旧版的exe文件，再下新版覆盖旧版，有问题不能解决可以恢复备份返回旧版

2. 下载ffmpeg，马娘插件发语音用的

方便起见，直接提供直链
我的直链：https://cloud.594594.xyz/uma_bot/ffmpeg.zip
一般无需更新

3. 下载hoshinobot 下面三任选一

三个版本的区别：

原版：
    由PCR中流砥柱的 [咖啡佬](https://github.com/Ice-Cirno) 开发，拥有星乃自带的功能
    有非常丰富的适用公主链接的小功能，PCR玩家推荐使用，还附带一些小彩蛋
    需要一些res资源，下面的原版链接的文档里面有，请自己去找和下载

不带任何插件的精简版：
    顾名思义，只有必要的功能，其他功能一个都没有，其实就是删了原版的PCR模块，其余构架未动和原版一致，强迫症狂喜，请给原开发者点个star支持一下

仅带赛马娘整合数据库插件的精简版:
    啥？你不玩PCR，那没事了，只要马娘功能的话，装这个就对了，但马娘插件版本不一定新，请后续自己按照插件README.md更新插件
    我已经把所有的马娘图片资源都塞进去了，所以会很大，也请给原开发者点个star支持一下

（1）原版链接：https://github.com/Ice-Cirno/HoshinoBot
（原版先不要急着下载，到 step 4 看第 4 步）

注：下方直链都是onedrive网盘，有些时候下载不一定快，敬请谅解

（2）不带任何额外插件的精简版(08-03更新)：https://cloud.594594.xyz/uma_bot/HoshinoBot-lite.zip

（3）仅带赛马娘整合数据库插件的精简版(08-03更新)：https://cloud.594594.xyz/uma_bot/HoshinoBot-lite-uma.zip
(整合包里带v2.6.0版的马娘插件，插件若想更新到最新版请看：https://github.com/azmiao/uma_plugin/ 的文档)

step 4 安装

将下载下来的六样东西，放在某个盘里，比如说放在D盘

接下来，用你自己的电脑同时按下两个按键 win键和 R键，会打开运行，输入mstsc，点确定，会打开远程桌面的窗口

这时候会弹出一个界面，点击左下角的“显示选项”，然后找到上方的“本地资源”，然后选择下方的“详细信息”，勾选上刚才放六个东西的那个盘然后点确定，这样你这个驱动器也可以在服务器上访问，就可以获取相互传文件了

接着在点击上方的“常规”，在计算机一栏输入刚才 step 2 让你记下来的云服务器的公网ip，然后点最下方“连接”，账户就是Administrator，密码就是 step 1 里的你自己设置的密码，这样就进入服务器了

稍微等待一会，就能进入桌面了

如果自动打开了服务器管理器的话，关闭就好了，然后在云服务器上打开“此电脑”或者资源管理器，进入刚才勾选的那个盘符，将六个东西复制过来：
4.1

！！之后所有操作均为在远程桌面连接到的服务器上操作！！

之后开始逐个安装：

notepad++ 和 Git 没有什么好说的，直接安装一路下一步点到低即可

其他4个的安装步骤：

1. 先打开python-3.8.10-amd64.exe

一定要先勾上最下面红色框里的这个选项，再点橙色部分安装，没有这样安装的请先卸载再重新装
4.2

等显示 “Setup was successful”即可点右下角 close 关闭窗口

2. 解压缩ffmpeg.zip

为了方便小白起见，解压到C盘根目录，目录请和我图中一致：
4.3

3. 添加环境变量

！！！如果服务器是win server 2012r2的话请先打开服务器管理并安装桌面体验！！！

然后，找到开始菜单的命令提示符注意一定要是命令提示符，不能是powershell，然后以管理员方式运行命令提示符：
4.3

然后输入命令：

1	`setx /M PATH "C:\ffmpeg\bin;%PATH%"`

完成就可以关闭命令提示符了

4. 配置 hoshinobot 精简版看 4.1 | 原版看 4.2 （二选一即可）

4.1 若使用我的两个精简版

解压缩下载的 HoshinoBot-lite.zip 或 HoshinoBot-lite-uma.zip ，并重命名成HoshinoBot，打开HoshinoBot文件夹，然后在左上角选择“文件”，然后点击“打开windows powershell”

在powershell里输入命令：

1	`pip config set global.index-url https://repo.huaweicloud.com/repository/pypi/simple`

然后再输入命令：

1	`py -m pip install --upgrade pip`

然后

1	`pip install -r requirements.txt`

没有红字报错即可关闭powershell，有报错请确保解决报错才能进行下一步

接着打开HoshinoBot\hoshino\config文件夹对着 __bot__.py右键选择 Edited with notepad++

找到第15行 SUPERUSERS = [10000] 将10000改成你自己的QQ号然后保存即可，这个是指机器人的主人QQ即维护组QQ，拥有最高权限

4.2 若使用原版 hoshinobot

随便找个地方，但不要是桌面，然后在资源管理器左上角选择“文件”，然后点击“打开windows powershell”，并输入下载命令（已使用镜像站）

1	`git clone https://ghproxy.com/https://github.com/Ice-Cirno/HoshinoBot.git`

然后：

1	`cd HoshinoBot`

然后开始安装依赖：

1	`pip config set global.index-url https://repo.huaweicloud.com/repository/pypi/simple`

然后再输入命令：

1	`py -m pip install --upgrade pip`

然后

1	`pip install -r requirements.txt`

没有红字报错即可关闭powershell

然后打开 HoshinoBot\hoshino 文件夹，将里面的 config_example 复制一份，并将复制的那一份改名 config 文件夹

接着打开HoshinoBot\hoshino\config文件夹对着 __bot__.py右键选择 Edited with notepad++

找到第 7 行，将端口的 8080 改成 2333 （因为我的go_cqhttp配置端口改成了2333，只要这俩同步就行）

找到第15行 SUPERUSERS = [10000] 将10000改成你自己的QQ号然后保存即可，这个是指机器人的主人QQ即维护组QQ，拥有最高权限

原版需要res资源包，请去原版hoshino文档找并下载：hoshinobot

5. 配置go_cqhttp

将 go_cqhttp.zip 随便解压到一个文件夹，并打开文件夹里的 config.yml 配置文件

将第 4 行的 uin: 123456 中的123456改成你的机器人QQ，password的引号里填写这个QQ的密码保存即可，这个是指你想拿来做机器人的一个QQ小号

step 5 开始使用

打开HoshinoBot文件夹，双击运行.bat，即可开启hoshino，如果闪退说明报错了，请尝试在该位置打开powershell，输入:

1	`python run.py`

以便查看报错内容。

然后打开go_cqhttp文件夹，双击打开 go-cqhttp.bat 并按照提示登录，即可开启gocqhttp

如果提示登陆风险，可尝试吧gocqhttp文件移动到自己电脑上，登录完再移动到服务器上。

如果你先打开gocqhttp就会一直提示反向代理链接失败，是正常的，因为目的就是让hoshino链接上gocqhttp，这时候再打开hoshino，等进度走完才能连接gocqhttp

当以上两者成功握手的时候说明机器人可以用了，正常握手的状态：

出现这一行即可，打马赛克那一小段代表那里不重要，不用看
5.1

注意：如果是带马娘插件的版本，首次开启hoshino可能会先自动更新数据，请耐心等待更新完才会出现这一行，由于数据量大首次启动需要一定的时间。马娘插件版如果首次启动很快没有新的日志，即没有出现更新操作，请查看日志是否是马娘插件版本获取失败，如是，说明你的服务器连不到Github，需要手动按照下文额外定制功能配置代理或者关闭自动更新功能。另外建议更新完数据后到插件目录/hoshinobot/hoshino/modules/uma_plugin里，使用命令git pull将插件也更新到最新版本以防BUG。

这时候你可以私聊你的机器人发一句“在？” 若有回复说明搭建完成了

然后在群里发送“帮助”，即可获取机器人相关的帮助提示

注1：无任何插件的精简版发送“帮助”，可以看到里面没有功能，是正常的，毕竟精简完了，要功能请看额外部分1

注2：带马娘插件的精简版就可以直接输入命令 “马娘帮助” 开始玩耍啦

请务必看一下这个：

但是重点来了，如果你的机器人QQ是新号，那100%会风控，一般使用go_cqhttp 3-7天就会自动解除

go_cqhttp常见问题

风控是指：发送消息会遇到发不出或者显示发送了但实际未接收到的情况

如果 7 天后仍然处于风控状态，请看本文最底部的风控解决方案，我研究出了一种很有可能解决风控的问题的方法。

额外部分1 (请也务必看一下)

一个正常的机器人已经搭建好了，如果想要添加功能怎么办呢，不妨去看看 hoshinobot插件索引可以点个star哦

大佬们都是用爱发电，无偿开源代码的，一般插件使用方法：

打开 HoshinoBot\hoshino\modules 文件夹，把插件的文件夹扔进来，当然使用powershell 命令更方便:

1	`git clone 仓库链接`

举个栗子（比如想要装我的马娘插件整合版）：

1	`git clone https://github.com/azmiao/uma_plugin`

然后打开HoshinoBot\hoshino\config文件夹对着 __bot__.py右键选择 Edited with notepad++

再到最底下添加（注意缩进和格式和其他插件一样哦）：

1	`'uma_plugin',`

但是，重点又来了，很多插件有依赖要装，也有一些其他要求，我的马娘整合插件也一样，所以装插件前请切记切记切记：

一定要看文档！一定要看文档！一定要看文档！

比如我的马娘插件整合版请仔细阅读 https://github.com/azmiao/uma_plugin，另外，插件时不时会更新功能和修复BUG，如何监控我的更新您可以看插件文档内容

额外部分2 (给使用带马娘整合插件的hoshino 看的)

由于使用了带马娘整合插件的hoshino，有一些简单的额外步骤：

请根据自己的想法而定是否开启

在某个群里发消息输入下文以开启马娘生日提醒

1	`开启 uma_bir_push`

在某个群里发消息输入下文以开启马娘新闻播报（两个命令，一个日服，一个台服）

1	`开启 umamusume-news-poller`

1	`开启 umamusume-news-poller-tw`

可以通过发消息输入”lssv”查看这个功能前面是不是⚪来确认是否开启成功

风控解决方案

使用本方案前，请务必保证 QQ号已过 7 天的必定风控时间

需要的东西，一个APP：AIDA64 ，一台手机（建议安卓，IPhone我不知道有没有AIDA64这软件）

开始

打开服务器上的go_cqhttp文件夹，找到其中的 device.json 并右键选择 Edited with notepad++

打开后可以看到：

{"display":"MIRAI.113762.001","product":"mirai","device":"mirai","board":"mirai","model":"mirai","finger_print":"mamoe/mirai/mirai:10/MIRAI.200122.001/3727967:user/release-keys","boot_id":"94082b20-1682-7922-d652-bac86a18f19d","proc_version":"Linux version 3.0.31-u0vVAoKf (android-build@xxx.xxx.xxx.xxx.com)","protocol":5,"imei":"065836319212383","brand":"mamoe","bootloader":"unknown","base_band":"","version":{"incremental":"5891938","release":"10","codename":"REL","sdk":29},"sim_info":"T-Mobile","os_type":"android","mac_address":"00:50:56:C0:00:08","ip_address":[10,0,1,3],"wifi_bssid":"00:50:56:C0:00:08","wifi_ssid":"\u003cunknown ssid\u003e","imsi_md5":"9105a13703f11f1517c6d5c0908930ba","android_id":"a083d19ee9f54c37","apn":"wifi","vendor_name":"MIUI","vendor_os_name":"mirai"}

这就是go_cqhttp生成的随机虚拟设备信息

我们需要把他换成你的手机的真实设备信息，所以可以用AIDA64读取手机数据

这是我自己用的，部分信息已打码(已用*****标注)，其他未打码的信息可以直接抄：

{
  "display":"MI9",
  "product":"cepheus",
  "device":"cepheus",
  "board":"cepheus"
  ,"model":"MI 9",
  "finger_print":"Xiaomi/cepheus/cepheus:11/******************/************r/re**********s",
  "boot_id":"R************2",
  "proc_version":"Linux versio*************x.xxx.xxx.com)",
  "protocol":1,
  "imei":"5**************0",
  "brand":"Xiaomi",
  "bootloader":"unknown",
  "base_band":"1.0******************867e53",
  "version":{
    "incremental":"5************8",
    "release":"11",
    "codename":"REL",
    "sdk":30
    },
  "sim_info":"T**********e",
  "os_type":"android",
  "mac_address":"**:**:**:**:**:**",
  "ip_address":[**,*,*,*],
  "wifi_bssid":"**:**:**:**:**:**",
  "wifi_ssid":"<cunknown ssid>",
  "imsi_md5":"9**********************c",
  "android_id":"9***********0",
  "apn":"wifi",
  "vendor_name":"MIUI",
  "vendor_os_name":"MIUI"
}

改完后保存退出，然后删除 go_cqhttp文件夹下方的session.token文件

然后重启go_cqhttp即可，如果这样还是不能解决风控，那我真没办法了2333

备注：删除 go_cqhttp文件夹下方的session.token文件，可能可以直接解决风控，但光这样可能几个小时后又风控了，要不你闲的蛋疼，试试每几个小时删一次？