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

优质文章学习记录

10 Apr 2026 — 4 min read

准备工作

一台轻量级服务器/ 本地windows/linux能够在服务器/本地科学上网

环境部署

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

Ubuntu 24.04.

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

确保已成功安装git

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

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

创建虚拟环境

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

Windows可直接运行pip install uv

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

安装虚拟环境包

（退出虚拟环境的命令：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，如在本地部署请忽略

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