1.前言

沒有前言，這篇教程主要參考作者官方文檔搭建緒山真尋bot，可愛捏。

功能也很多哦！

2.項(xiàng)目地址

GitHub地址：github.com/HibiKier/zhenxun_bot

幫助文檔地址：hibikier.github.io/zhenxun_bot

本文基本參考上面幫助文檔，稍微添加了一點(diǎn)細(xì)節(jié)。小伙伴們有啥問題可以去看看官方文檔哦！搭建中的提示圖片夜夢(mèng)過段時(shí)間加上（咕咕咕）

有啥更新的話在夜夢(mèng)的博客里面：tech.yemengstar.com/?p=2736

3.搭建準(zhǔn)備

夜夢(mèng)這里采用Ubuntu22.04版本安裝。

PS：夜夢(mèng)折騰了一下午已經(jīng)成功了，并且配置好了基本的API，所以下面的過程應(yīng)該不會(huì)有太大問題。

（ERROR了的話當(dāng)我沒說

• 一個(gè)QQ號(hào)（拿小號(hào)?。?/p>

• 一臺(tái)服務(wù)器

• 稍微了解一點(diǎn)Linux命令

• 一定的百度/bing/Google的能力

• 面對(duì)ERROR不放棄的耐心和決心

自建可能會(huì)遇到各種花里胡哨的麻煩，如果沒有一些基礎(chǔ)的話，前面可是困難重重啊少年！

夜夢(mèng)全程以root身份進(jìn)行搭建！

4.安裝go-cqhttp

4.1下載

go-cqhttpGitHub地址：https://github.com/Mrs4s/go-cqhttp

release地址：Releases · Mrs4s/go-cqhttp (github.com)

這里我們選擇這個(gè)：https://github.com/Mrs4s/go-cqhttp/releases/download/v1.0.1/go-cqhttp_linux_amd64.tar.gz

我們先新建一個(gè)文件夾，方便后面的管理：

再建一個(gè)文件夾，用來放go-cqhttp：

然后把go-cqhttp下載到這個(gè)文件夾中：

然后解壓文件到這個(gè)文件夾中：

4.2配置

解壓后會(huì)得到go-cqhttp，首次運(yùn)行會(huì)讓你選擇通信方式，選擇?3?(反向 Websocket 通信)，會(huì)生成一個(gè)配置文件config.yml

然后我們按ctrl+c退出

這個(gè)時(shí)候我們修改config.yml文件：

然后按i進(jìn)入修改模式（后面也一樣）：

1.找到uin: 123456修改為你自己的qq機(jī)器的賬號(hào)，比如uin: 654321

2.找到password:''，在''中填入你的密碼。

3.然后，我們向下翻，找到并修改universal：

universal: ws://your_websocket_universal.server
修改為
universal: ws://127.0.0.1:8080/onebot/v11/ws/

按esc后，輸入:wq保存退出（后面也一樣）。

4.3啟動(dòng)

退出后，我們輸入在gocq文件夾中，輸入./go-cqhttp運(yùn)行。

按照提示選擇驗(yàn)證后，登錄進(jìn)入賬號(hào)（建議開啟設(shè)備鎖，直接使用驗(yàn)證碼更加可靠）。

成功后會(huì)提示警告CONNECTION REFUSED，別擔(dān)心，這些提示將在完成真尋啟動(dòng)時(shí)消失。

到這一步已經(jīng)成功完成gocq方面的配置了，可以進(jìn)行下一步！

5.安裝Postgresql數(shù)據(jù)庫(kù)

5.1安裝

直接命令行輸入：

創(chuàng)建數(shù)據(jù)庫(kù)和用戶（依次輸入）：

然后我們

退出數(shù)據(jù)庫(kù)并且切回root用戶。

到這里我們已經(jīng)成功完成了Postgresql的數(shù)據(jù)庫(kù)配置，馬上要安裝真尋了捏！

5.2配置外網(wǎng)連接（可省略）

夜夢(mèng)這里就不寫了，需要的小伙伴自己看官方文檔哦！

https://hibikier.github.io/zhenxun_bot/docs/installation_doc/psql_ubuntu.html

6.安裝真尋Bot

6.1下載依賴

咱這里回到主目錄下新建一個(gè)文件夾放bot的文件：

從?HibiKier / zhenxun_bot (opens new window)?clone代碼：

6.2安裝依賴

安裝依賴包，依次執(zhí)行以下內(nèi)容：

6.3設(shè)置超級(jí)用戶

設(shè)置超級(jí)用戶，打開?.env.dev?文件，在SUPERUSERS中添加自己的QQ：

將SUPERUSERS=["123456789"]中修改成自己的主人（超級(jí)管理員）QQ號(hào)

6.4填寫數(shù)據(jù)庫(kù)數(shù)據(jù)

進(jìn)入?configs?目錄并打開?config.py?文件填寫數(shù)據(jù)庫(kù)數(shù)據(jù)。

如果你從開頭到現(xiàn)在都跟著夜夢(mèng)的教程進(jìn)行的，那么你只需要將：

修改為：

如果上面在填寫數(shù)據(jù)庫(kù)的時(shí)候修改了部分信息，那么就按照你修改的來填寫。

6.5啟動(dòng)真尋

然后我們回到zhenxun_bot的目錄下。（有?bot.py?文件的目錄）

然后我們就可以啟動(dòng)真尋醬了：

首次啟動(dòng)會(huì)下載資源，時(shí)間較久，請(qǐng)耐心等待。

有報(bào)錯(cuò)也不用管（反正夜夢(mèng)也不會(huì)解決

啟動(dòng)完成后，會(huì)在?configs?和?data/configs?目錄下生成各種配置文件，我們按需修改即可，通常只是填寫API接口。夜夢(mèng)會(huì)在后面演示填寫一些。

但是！

我們這里只是啟動(dòng)了zhenxun_bot，還沒啟動(dòng)go-cqhttp呢，如果想要同時(shí)啟動(dòng)這兩個(gè)并且保持持久化運(yùn)行，我們需要用到screen。

zhenxunbot已經(jīng)正常運(yùn)行了呀

7.持久化運(yùn)行

7.1安裝screen

7.2創(chuàng)建會(huì)話——zhenxun_bot

在隨便哪個(gè)目錄下運(yùn)行：

創(chuàng)建一個(gè)screen給真尋。

進(jìn)入到zhenxun_bot目錄下。

運(yùn)行：

然后按CTRL+A+D退出screen即可！

7.3創(chuàng)建會(huì)話——gocq

進(jìn)入我們的gocq文件夾后，輸入

然后輸入：

即可運(yùn)行！

再按CTRL+A+D退出screen。

到這里，我們機(jī)器人的配置就完成了~

你可以試試真尋醬啦~

7.4重回會(huì)話

使用以下命令恢復(fù)會(huì)話：

8.檢查運(yùn)行情況

在沒有修改默認(rèn)端口的情況下，輸入：

可以查看真尋是否在線，顯示下面四條信息說明成功運(yùn)行了。

9.修改config.ymal

9.1修改config.ymal

這里夜夢(mèng)推薦使用https://www.xshell.com/zh/xftp/

進(jìn)行本地化操作。

在使用XFPT連接到服務(wù)器后，我們進(jìn)入到/zhenxunbot/zhenxun_bot/configs/文件夾中，右鍵使用記事本編輯config.ymal文件。

然后小伙伴們應(yīng)該都會(huì)的，記事本都會(huì)用的吧，改完直接CTRL+S保存就行。

夜夢(mèng)推薦修改的有（自己到網(wǎng)站注冊(cè)獲取API的）：

• alapi

• search_image

• translate

如果想要使用天氣插件，還需要在plugins文件夾中找到weather文件夾，進(jìn)入后用記事本編輯data_source文件。需要修改的位置在else中，先到

• yiketianqi.com

注冊(cè)一個(gè)賬號(hào)，然后找到自己的APPID和APPSECRET，填入下方的else中就好了：

9.2重啟真尋醬

分別回到兩個(gè)screen中按CTRL+C暫停運(yùn)行，然后按照上面的指令重新運(yùn)行啟動(dòng)一遍就好了。

10.后記

到此真尋bot已經(jīng)搭建完成了，你可以在群里呼喚真尋幫助查看全部指令哦！

PS：你也可以參考官方給出的使用文檔食用！

https://hibikier.github.io/zhenxun_bot/docs/help_doc/