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)上面查看教程,或者是自行百度/必应/谷歌搜索。
下面丢张真寻酱的互动图: