领养一只可爱的Q群机器人——绪山真寻Bot(Win版本保姆级教程)
本文发布于381天前,最后更新于210天前,其中的信息可能有所发展或是发生改变。如有疑问请联系邮箱:admin@yemengstar.com。

1.前言

前两天夜梦写了如何在Ubuntu系统上面搭建Q群机器人,但是肯定有小伙伴不熟悉Linux的命令。所以这篇文章夜梦将在Windows系统上面进行演示。

本文基本上是保姆级的教程了,光截图就有四五十张,应该算是通俗易懂的了。

2.项目地址

GitHub地址:github.com/HibiKier/zhenxun_bot

帮助文档地址:hibikier.github.io/zhenxun_bot

本文基本参考上面帮助文档,稍微添加了点细节。小伙伴们有啥问题可以去看看官方文档哦!

3.搭建准备

夜梦这里采用腾讯云的Windows服务器进行演示(Windows Server 2019 数据中心版 64位 中文版),自己的电脑也一样的。但是如果自己的电脑上面怎么都弄不成,可能是因为环境的问题,夜梦真心建议使用腾讯云服务器之类的,省时省力,毕竟时间无价 → https://curl.qcloud.com/ZDvHmvsq

主要要准备的是:

  • 一个QQ号(拿小号!)
    • 夜梦推荐开启安全保护或者是设备锁!
  • 一台Windows系统的服务器或者是自己的电脑
  • 稍微了解一点cmd命令
  • 一定的百度/bing/Google的能力
  • 面对ERROR不放弃的耐心和决心

自建可能会遇到各种花里胡哨的麻烦,如果没有一些基础的话,前面可是困难重重啊少年!

4.安装go-cqhttp

4.1下载

Windows下载这个版本的gocq(国内的话下载的可能比较慢,不要着急~):

https://github.com/Mrs4s/go-cqhttp/releases/download/v1.1.0/go-cqhttp_windows_amd64.zip

这个下载是zip,需要先解压一下,然后我们进入powershell:

请注意,路径最好为全英文,比如:

然后我们在文件中找到go-cqhttp,我们的目标就是启动它:

4.2启动gocq

powershell进入你的go-cqhttp所在的文件夹。

然后输入

./go-cqhttp.exe

启动go-cqhttp

4.3配置

运行的时候会提示让你选择通信方式,我们这里选择3 (反向 Websocket 通信)

然后回车确定,这里提示已经生成了配置文件,我们需要进行配置。我们先关闭powershell,然后:

找到config.yml文件,这里直接用记事本打开就能改。

config.yml文件中中的uin修改为自己的机器人账号,并且填入密码:

别把中间的空格删了!

然后修改代理:

把:

universal: ws://your_websocket_universal.server

修改成:

universal: ws://127.0.0.1:8080/onebot/v11/ws/

4.4启动

保存完文件退出以后,我们依照上面的方法重新启动go-cqhttp
我们会看到验证提示,这里我们选择1.自动提交

然后你会看到一个链接,复制到浏览器里面打开就行,验证完以后,如果你的QQ开启了安全保护设备锁什么的,那你可能会看到下面的提示:

这里我们选择向手机发送验证码,也就是1

然后你会接到一个验证码,输入回车即可。

然后不出意外的话登录是能够登陆上的,但是会遇到一堆WARNING:

别管它们,关了这个窗口就行。接下来我们安装postgresql数据库。

5.安装postgresql数据库

5.1下载

下载:https://get.enterprisedb.com/postgresql/postgresql-15.1-1-windows-x64.exe

5.2安装

下载下来以后,双击安装程序,点击Next

选择安装路径(没有特殊情况一般默认即可),继续Next

注意安装路径请不要出现中文!

去掉Stack Builder即可,不影响使用,Next

数据存储路径(没有特殊情况一般默认即可),Next

输入postgres用户的密码,例如: zhenxun_bot

默认端口,Next

接下来一路Next直到进入安装

安装完成!

5.3基本设置

找到安装的pgAdmin:

点击启动。

我们需要先设置一个管理员密码,这里还是输入zhenxun_bot,当然了,你可以自己输,这个不影响。

这个数据库的界面是英文,如果想要调整成中文的话也很简单。

在左上角的file里面,找到preference:

然后找到user language切换成Chinese即可!

右下角save一下,然后刷新一下就是中文界面了!

5.4新建连接

左侧栏右键点击Servers后选择Register,在点击服务器

随便起一个名字就行

然后继续在上面的连接选项中继续完成配置。

填写主机名称/地址,这里我们本地的话可以直接填写127.0.0.1
端口就是安装时配置的端口,没有修改的话默认5432
密码就是安装时配置的密码,比如夜梦这里就是zhenxun_bot

然后点击保存即可!

5.5创建数据库

选中左侧刚刚创建的zhenxunbot,点击创建数据库:

夜梦还是以zhenxun_bot这个名字为例,设置数据库名称后点击保存

到这里数据库就配置完成了!

6.安装真寻Bot

6.1安装python3.10

3.9也可以,如果后面报错,可以尝试降低python版本!

如果已经有python了那就不需要了,没有的话这里先装一下:

下载地址:https://www.python.org/ftp/python/3.10.9/python-3.10.9-amd64.exe

安装很简单,首页勾上add python.exe to PATH以后一路next就行了。

安装完记得重启一下电脑。

安装完可以在powershell中使用

python --version

查看python版本。

6.2下载真寻

下载地址:https://github.com/HibiKier/zhenxun_bot/archive/refs/heads/main.zip

6.3安装依赖包

下载完以后解压到纯英文目录的文件夹下(夜梦推荐新建一个文件夹):

依旧是使用powershell进入这个文件夹,然后依次执行:

pip3 install poetry     # 使用poetry管理python包
poetry install          # 安装依赖

poetry shell            # 进入虚拟环境

## playwright 需要安装额外的系统环境,在命令行输入以下
playwright install chromium

国内网络安装依赖可能较慢,耐心等待即可。安装完全部的依赖以后,我们在这个文件夹下面找到.env.dev文件。

6.4设置超级用户

用记事本打开.env.dev 文件,在SUPERUSERS中添加自己的QQ

SUPERUSERS=["123456789"]

6.5填写数据库信息

还是用万能的记事本打开configs/config.py 查看数据库数据信息,并进行更改。

# 数据库(必要)
# 如果填写了bind就不需要再填写后面的字段了#)
# 示例:"bind": "postgres://user:password@127.0.0.1:5432/database"
bind: str = ""  # 数据库连接链接
sql_name: str = "postgres"
user: str = ""  # 数据用户名
password: str = ""  # 数据库密码
address: str = ""  # 数据库地址
port: str = ""  # 数据库端口
database: str = ""  # 数据库名称
如果你至始至终是与夜梦教程一模一样的命令代码,那你可以直接复制以下配置
bind: str = ""  # 数据库连接链接
sql_name: str = "postgres"
user: str = "postgres"
password: str = "zhenxun_bot"
address: str = "127.0.0.1"
port: str = "5432"
database: str = "zhenxun_bot"

6.6启动真寻

启动真寻后,会在 configs 和 data/configs 目录下生成各种配置文件

python bot.py

首次启动会报错,需要我们修改文件:

打开 configs/config.yaml

里面包含的是各种插件的配置项,按需填写即可。填写完毕后重启真寻Bot

首次启动会下载资源,时间较久,请耐心等待。

里面有些资源可能会解析出错,不用管他,等待完成即可。

如果启动没有问题,等到启动完成以后,我们再次打开gocq。

7.再次启动gocq

再开一个powershell,在 powershell 进入你的 go-cqhttp 所在的文件夹。

然后输入

./go-cqhttp.exe

等待启动完成即可!

8.后记

如果有啥不对的话可以给夜梦发邮件哦,或者自行到绪山真寻Bot (hibikier.github.io)上面查看教程,或者是自行百度/必应/谷歌搜索。

下面丢张真寻酱的互动图:

9.报错问题

绪山真寻bot | 部分问题的解决办法

本文为夜梦星尘原创文章。
文章作者:夜梦星尘
文章链接:领养一只可爱的Q群机器人——绪山真寻Bot(Win版本保姆级教程)
版权声明:本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自夜梦星尘
支持作者:夜梦星尘的爱发电
上一篇
下一篇