前言

1. 1/16桶水的人整这些起来真的是坎坎坷坷，全程做个记录，方便日后查看。

2. 试过了Yunzai-Bot和LittlePaimon两种原神机器人，Yunzai-Bot确实更简单易懂，几乎无难度搭建，包括后续的插件应用，很便捷；但开放性以及插件量还是基于Nonebot的LittlePaimon会更佳。两边都试了试，整了十来天，综合考虑了下，想玩的更花一点（又菜又爱整活），最后还是选择搭建LittlePaimon。

搭建流程

前期准备

1. 云服务器1台，我选择的是华为云，AlmaLinux 8.4系统（CentOS流程差不多）；

2. SSH软件（putty、tabby）、SFTP文件传输软件（winscp）；

3. 科学上网工具（V2xxy、Clxxh），自行寻找配置。

环境安装

1. • 安装前置依赖

yum -y install gcc* make libffi-devel zlib-devel bzip2-devel openssl-devel ncurses-devel sqlite-devel readline-devel tk-devel

安装时间较长，可以再开一个SSH窗口同步进行第二步。

2. • 安装Python

2.1 下载Python-3.10.9

LittlePaimon建议安装python3.8-3.10，之前大概摸了一遍Nonebot的插件商店，发现需求python版本最高为3.10，因此选择安装3.10。

嫌慢也可以自己PC下载，用winscp丢上去服务器。

wget https://www.python.org/ftp/python/3.10.9/Python-3.10.9.tgz

2.2 安装python

tar -zxvf Python-3.10.9.tgz
cd Python-3.10.9
./configure
make && make install

2.3 确认python及pip版本

python3 -V
#返回'Python 3.10.9'则为安装成功
pip3 -V
#返回'pip 22.3.1 from /usr/local/lib/python3.10/site-packages/pip (python 3.10)'则为安装成功

2.4 建立软链接

若服务器本身带有python其他版本，输入python3 -V很有可能出现其他结果，因此需要建立软链接。

mv /usr/bin/python3 /usr/bin/python3.bak
#备份原链接
ln -s /usr/local/bin/python3 /usr/bin/python3
#建立python3软链接
ln -s /usr/local/bin/pip3 /usr/bin/pip3
#建立pip3软链接

不提倡的操作：在一些自带python2.X的系统中（没有python2.X也同样可用），输入python或pip默认为python2.X，若希望输入python或pip，等同于python3/pip3，则

ln -sf /usr/local/bin/python3 /usr/bin/python
ln -sf /usr/local/bin/pip3 /usr/bin/pip
#-s为建立软链接，-f为强制建立，即覆盖原软链接

2.5 安装poetry

pip install poetry
#time out就多试几次
poetry -V
#输出'Poetry (version x.x.x)'则为安装成功

3. • 安装git

yum -y install git
git version
#输出'git version x.x.x'则为安装成功

4. • 安装ffmpeg

想让机器人输出老婆or老公甜甜的声音？还是得装个ffmpeg

4.1 先安装yasm（ffmpeg使用的汇编器）

wget http://www.tortall.net/projects/yasm/releases/yasm-1.3.0.tar.gz
tar -zxvf yasm-1.3.0.tar.gz
cd yasm-1.3.0
./configure
make && make install

4.2 安装OpenCore-AMR

wget https://jaist.dl.sourceforge.net/project/opencore-amr/opencore-amr/opencore-amr-0.1.6.tar.gz
tar -xf opencore-amr-0.1.6.tar.gz
cd opencore-amr-0.1.6
./configure
make && make install

4.3 安装ffmpeg（如需最新版，官网自行寻找）

wget https://ffmpeg.org/releases/ffmpeg-5.1.2.tar.gz
tar -zxvf ffmpeg-5.1.2.tar.gz
cd ffmpeg-5.1.2
./configure --enable-gpl --enable-version3 --enable-nonfree  --enable-ffprobe --enable-libopencore-amrnb --enable-libopencore-amrwb
make && make install

4.4 检查安装情况

ffmpeg
#若输出'ffmpeg: error while loading shared libraries: libopencore-amrwb.so.0: cannot open shared object file: No such file or directory'，libopencore-amrwb.so.0可能为其他，则需建立软链接
ln -s /usr/local/lib/libavdevice.so.56 /usr/lib64/libavdevice.so.56
ln -s /usr/local/lib/libavfilter.so.5 /usr/lib64/libavfilter.so.5
ln -s /usr/local/lib/libavformat.so.56 /usr/lib64/libavformat.so.56
ln -s /usr/local/lib/libavcodec.so.56 /usr/lib64/libavcodec.so.56
ln -s /usr/local/lib/libswresample.so.1 /usr/lib64/libswresample.so.1
ln -s /usr/local/lib/libswscale.so.3 /usr/lib64/libswscale.so.3
ln -s /usr/local/lib/libavutil.so.54 /usr/lib64/libavutil.so.54
ln -s /usr/local/lib/libopencore-amrwb.so.0 /usr/lib64/libopencore-amrwb.so.0
ln -s /usr/local/lib/libopencore-amrnb.so.0 /usr/lib64/libopencore-amrnb.so.0
ln -s /usr/local/lib/libmp3lame.so.0 /usr/lib64/libmp3lame.so.0

#再次尝试输入ffmpeg，正常输出如下
ffmpeg
<< EOF
ffmpeg version 5.1.2 Copyright (c) 2000-2022 the FFmpeg developers
  built with gcc 8 (GCC)
  configuration: --enable-gpl --enable-version3 --enable-nonfree --enable-ffprobe --enable-libopencore-amrnb --enable-libopencore-amrwb
  libavutil      57. 28.100 / 57. 28.100
  libavcodec     59. 37.100 / 59. 37.100
  libavformat    59. 27.100 / 59. 27.100
  libavdevice    59.  7.100 / 59.  7.100
  libavfilter     8. 44.100 /  8. 44.100
  libswscale      6.  7.100 /  6.  7.100
  libswresample   4.  7.100 /  4.  7.100
  libpostproc    56.  6.100 / 56.  6.100
Hyper fast Audio and Video encoder
usage: ffmpeg [options] [[infile options] -i infile]... {[outfile options] outfile}...
EOF

5. • 安装Chromium（A WebKit (Blink) powered web browser that Google doesn't want you to use）

yum -y install chromium.x86_64
#如无可用yum search chromium寻找，还没有要么换源要么自行编译安装

安装LittlePaimon

1. • git clone拷贝项目

找个你想存放的目录，最好是非中文

git clone --depth=1 https://github.com/CMHopeSunshine/LittlePaimon

2. • 安装依赖

cd LittlePaimon
poetry install
#出错试试运行poetry run pip install -r requirements.txt

若报错'InvalidSchema: Missing dependencies for SOCKS support.'，是代王里问题，则

unset all_proxy
unset ALL_PROXY
pip install pysocks
#多试几次

3. • 手动下载资源包（可选）

点击链接下载，解压后resources文件夹放在LittlePaimon根目录下

4. • 修改配置文件

修改LittlePaimon根目录下的.env.prod

HOST=0.0.0.0 # Nonebot监听的IP，别改
PORT=13579 # Nonebot监听的端口，也可以设置成其他的，但是要记得
LOG_LEVEL=INFO # 日志等级
SUPERUSERS=["总之就是你的主QQ"] # 超级用户
NICKNAME=["总之就是机器人的昵称"] # 机器人的昵称
COMMAND_START=["想改成什么都行，尽量弄方便点"] # 命令前缀,根据需要自行修改
COMMAND_SEP=[""] # 命令分隔符

5. • 初次启动LittlePaimon

poetry run nb run
#等待资源下载完成后可Ctrl+C关闭

6. • 安装go-cqhttp插件

poetry run nb plugin install nonebot-plugin-gocqhttp

再次启动LittlePaimon

[INFO] nonebot_plugin_gocqhttp | Startup complete, Web UI has served to http://0.0.0.0:13579/go-cqhttp/

出现以上信息后，PC浏览器打开，访问127.0.0.1:13579/go-cqhttp/，服务器改成公网地址:13579/go-cqhttp/，进入Go-cqhttp插件管理界面，点击添加账号，输入机器人QQ账号密码，登录设备建议选Android Phone或iPad，之后重启LittlePaimon，根据提示登录账号。

之后可尝试登录127.0.0.1:13579/LittlePaimon/login（服务器自行更改公网IP），账号为超级用户QQ账号，密码默认为admin，可便捷管理LittlePaimon的一些插件。

7. • 错误处理

1. 登录失败

如出现“登录失败: 密码错误或账号被冻结”的提示，尝试更换登录设备，如更换后仍无法登录，建议换个QQ或放置几天。

2. socks问题

出现以下错误时，多半是使用了socks，但是python表示依赖未安装。

ImportError: Using SOCKS proxy, but the 'socksio' package is not installed. Make sure to install httpx using `pip install httpx[socks]`.

pip install pysocks
pip install httpx[socks]
pip install -U requests[socks] --ignore-installed
#一个个试过去，前面加poetry run

Screen后台运行

使用screen保证LittlePaimon在后台不间断运行。

yum -y install screen

使用以下指令可进行简单操作，按下CTRL+A+D可将当前screen作业挂在后台。

screen -S genshin
#打开一个名为genshin的screen作业
screen -ls
#查看目前所有的screen作业
screen -r xxxx
#恢复指定ID的screen作业，具体ID用-ls查看

安装插件

进入NoneBot插件商店，即可浏览插件，大部分插件使用以下指令即可安装

poetry run nb plugin 插件名

备注：插件安装完记得要重启LittlePaimon方可生效。

1. 一些插件安装后，若启动时其他插件显示error，尝试输入重新安装依赖

poetry install

2. 如需更新Nonebot，输入

pip install --upgrade nonebot2