【教程】手把手教你从零开始搭建一个多模态聊天机器人

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 信息