教你一步步在 服务器/本地(Linux/Windows) 部署鸣潮QQ机器人，并将其接入大语言模型，实现通过机器人进行库街区签到、练度查询、攻略查询等功能 （1）

准备工作

环境部署

笔者所演示的环境为阿里云服务器（2核CPU，2GIB内存，40GIB系统盘），操作系统为

Ubuntu 24.04.

确保已成功安装Python环境（版本须>3.8， 建议>=3.12，不建议>=3.13）

确保已成功安装git

如果你没有安装git且的系统是ubuntu，安装git只需要输入

sudo apt-get install git

如果系统为Windows，则自行前往 🔗官网 下载安装包安装即可

创建虚拟环境

从 Python 3.11 开始，Debian 和 Ubuntu 默认启用了 "Externally-Managed-Environment"（外部管理环境）保护机制，防止用户直接使用 pip 安装包到系统 Python 环境中，以避免破坏系统依赖。因此我们选择创建一个虚拟环境，每次使用之前只需要启动环境即可。

Windows可直接运行pip install uv

如果直接安装uv可能会出现以下错误

安装虚拟环境包

# 安装 python3-venv 虚拟环境包
sudo apt update
sudo apt install python3.12-venv

# 如果不确定 Python 版本，也可以安装通用的包
sudo apt install python3-venv python3-full

# 在opt目录下创建文件夹mcbot
sudo su # 回车后输入你的管理员密码
cd /
cd opt
mkdir mcbot
cd /opt/mcbot

# 创建虚拟环境，命名为mcvenv
python3 -m venv mcvenv

# 激活虚拟环境
source mcvenv/bin/activate

（退出虚拟环境的命令：deactivate）

激活虚拟环境并安装uv

# 激活虚拟环境
source mcvenv/bin/activate

# 在虚拟环境安装uv
pip install uv

安装插件

安装GsCore

早柚核心文档http://​https://docs.sayu-bot.com/​

进入opt/mcbot，输入如下命令

git clone https://github.com/Genshin-bots/gsuid_core.git –depth=1 –single-branch

cd gsuid_core

运行GsCore

uv run core

忽视警告

如在服务器上部署请按照说明修改config.json中的host为0.0.0.0，如在本地部署请忽略

sudo nano /opt/mcbot/gsuid_core/data/config.json

Ctrl + x 退出并保存，回车确认

配置服务器端口8765

由于Gscore运行在8765端口，我们需要在服务器的防火墙处添加对应的规则

安装XutheringWavesUID鸣潮插件

进入插件目录，安装XWUID

cd gsuid_core/plugins

# 安装XutheringWavesUID
git clone https://github.com/Loping151/XutheringWavesUID.git

安装库街区签到插件

# 在plugins目录下安装库街区签到插件
git clone –depth=1 https://github.com/Loping151/RoverSign

重启早柚插件

可以看到刚刚安装的插件成功导入了

安装nonebot

另外创建一个会话窗口，进入mcbot目录，运行虚拟环境，安装nonebot

cd opt/mcbot

# 激活虚拟环境
source mcvenv/bin/activate

# 安装nb
pip install nb-cli-plugin-bootstrap nb-clil

运行nb bs，将文件夹命名为onebot，空格选中，回车确定

配置图如下

进入onebot目录，连接早柚插件，可能需要科学上网

cd onebot

nb plugin install nonebot-plugin-genshinuid

运行onebot

nb run

配置防火墙端口8080