【教程】手把手教你從零開始搭建一個多模態聊天機器人

0. 什麼是 Naturel_GPT ？

Naturel_GPT 是一個開源免費的，基於 nonebot2 平臺的聊天 AI 插件，它可以讓你用自然語言和不同的人格進行交流，還可以調用各種擴展功能，如發送圖片、語音、郵件，以及上網進行搜索等。你可以自定義 TA 的性格、回覆風格等，也可以隨時切換不同的人格。TA 還有一定的記憶能力，可以記住對你的印象和聊天記錄，甚至可以澀..（劃掉）扮扮貓娘什麼的更是不在話下。還支持接入 Minecraft 服務器，讓 TA 在遊戲中執行各種複雜的 NBT 指令等。NG 是一個人性化、有趣、強大、可擴展的聊天 AI 插件。

該項目於23年一月末開始立項開發，經過數月的迭代開發，目前版本功能相對穩定，但仍有一些 bug 和不足之處，歡迎大家提出建議和意見。項目開源地址，當然，在此過程中，也有許多羣友分享了各種有趣的人設，歡迎體驗！谷歌文檔

爲了部署該項目，你需要準備以下內容：

一臺用於部署 NG 的服務器（本地PC也可，但是部署操作略有不同；雲服務器可以24小時運行，並且不佔用本地資源，更適合實用環境，故本教程以雲服務器環境爲例）
一個有試用餘額的 openai 賬號（新賬號默認贈送5刀）
一個用於運行 bot 的 qq 賬號

效果演示：

角色扮演

探討人生

奇怪play

替身召喚

想不出

前置知識

nonebot2: Naturel_GPT 是一個 nonebot2 的插件，nonebot2 是一個 Python 異步機器人框架，它允許你用 Python 語言編寫 QQ 機器人插件。
gocqhttp: nonebot2 依賴於 gocqhttp 與 QQ 通信，gocqhttp 是一個基於 Mirai 以及 MiraiGo 的 OneBot Golang 原生實現，你可以簡單地理解爲它是一個運行在服務器上的 QQ 客戶端。
openai_key: 要使用 Naturel_GPT，你需要至少一個 OpenAI 的 API 密鑰，你需要一個 OpenAI 賬號，然後在 OpenAI 官網生成一個 API 密鑰，使用密鑰請求時會消耗你的 API 額度，新賬號有 5 美刀的免費額度(openai 的賬號申請可以在 b 站找到大量教程)，大約足夠體驗 10000 次以上請求（使用默認的 GPT3.5-turbo 模型）用完了再註冊新的賬號。
由於 OpenAI 服務在一些地區無法訪問，你需要有基礎的魔法學知識和手段（NG 支持使用自定義代理），或者直接使用其他地區的服務器部署。
ssh: ssh 是一種遠程登錄協議，用來在服務器上執行命令，你需要在服務器上安裝 ssh 服務（大多數雲服務器自帶），並且在本地使用 ssh 命令連接服務器。(推薦使用 Termius，內置了 SFTP 功能，便於在本地和服務器之間傳輸文件)
screen: 在 linux 上，如果你關閉了 ssh 連接，那麼你的程序也會隨之關閉，爲了避免這種情況，你可以使用 screen 命令來保證 gocqhttp 和 nonebot2 在後臺運行，即使你關閉了 ssh 連接，程序也會繼續運行。
vim: vim 是 linux 上的一個文本編輯器，你可以使用它來編輯文本文件，如 nonebot2 的配置文件、gocqhttp 的配置文件等，如果你不熟悉 vim，你可以將文件下載到本地，使用其他編輯器編輯後再上傳到服務器。

2. 部署流程

本教程不包含擴展模塊和 Minecraft 服務器接入相關的內容，如果反饋較好的話這些內容會在下一期更新

2.1 服務器準備

推薦使用 Ubuntu LTS 作爲服務器系統，其他系統也可以，但是具體操作可能會有所不同，在此以 Ubuntu 23.04 x64 爲例，如果是新購買的服務器可以照抄選擇相同版本。

2.2 連接服務器

使用termius連接服務器，如圖所示分別填寫服務器地址、用戶名、密碼（從你購買的雲服務器商獲取）

連接成功後界面應當如圖所示

此時就可以輸入並在服務器上執行指令啦

2.3 安裝 screen

apt install screen

tips: 使用 ctrl+shift+v 可以在終端粘貼命令

2.4 安裝 Nonebot2

創建一個文件夾存放 nonebot 相關文件並進入

mkdir shiroha && cd shiroha

創建 python 虛擬環境

sudo python3 -m venv venv

啓用虛擬環境

source venv/bin/activate

安裝 nb-cli 腳手架（用於構建 nonebot 項目）

pip install nb-cli

創建 nonebot 項目

nb create

執行後如果出現如圖所示界面表示進入 nonebot 項目構建流程，此時可使用方向鍵上/下選擇選項，使用回車確定/勾選

這裏選擇 bootstrap，然後回車

接下來是起一個項目名，自由發揮即可（例：shiroha）

選擇驅動器：保持默認直接回車即可

適配器選擇：勾選 OneBot V11（即使用qq），如果要連接 Minecraft 服務器還需要選擇 Minecraft 適配器

後兩項分別是是否立即安裝依賴和是否創建虛擬環境：均直接回車，默認選擇是

等待依賴安裝完畢後出現是否安裝內置插件，這兩個都不需要，直接回車即可

出現下圖所示輸出時說明項目構建完成

進入剛剛創建好的項目並啓動

cd shiroha # 此處爲你的項目名
nb run

此時 nonebot 已經成功啓動啦，不過還缺少一些必要的配置，我們先按下 ctrl+c 結束掉程序方便下一步操作

nonebot 環境配置

在當前目錄下使用 vim .env.prod 編輯環境配置內容爲如下所示

vim編輯方法：進入 vim 後按一下 i 鍵，此時進入編輯模式，編輯完成後按下 ESC 輸入 :wq 並回車保存

DRIVER=~fastapi
HOST=127.0.0.1 # 配置 NoneBot2 監聽的 IP/主機名
PORT=8000 # 配置 NoneBot2 監聽的端口COMMAND_START=["!", "！"] # 配置命令起始字（如果不想要在使用命令時加上前綴可以將該項值設置爲 [''] ）

接下來我們還要部署 gocqhttp，才能使 bot 能夠讀取和發送 qq 信息