# Yunzai-Bot手动win教程

**Repository Path**: YSDRS2008/maoyvna

## Basic Information

- **Project Name**: Yunzai-Bot手动win教程
- **Description**: 三种win云崽搭建教程﹠整理叫全面的py插件教程，插件和ffmpeg等配置教程， 非常详细字数较多，感谢使用本教程

- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2024-07-24
- **Last Updated**: 2024-07-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


 ### 关于win（电脑）yunzai机器人安装教程૮₍ᵔ⤙ᵔ ₎ა  

 **૮₍ᵔ⤙ᵔ ₎ა**   :tw-1f1f2:  :tw-1f1fe:  :tw-1f1f3:   **૮₍ᵔ⤙ᵔ ₎ა** 

ฅ( ̳• ◡ • ̳)ฅ   ฅ( ̳• ◡ • ̳)ฅ  ฅ( ̳• ◡ • ̳)ฅ  ฅ( ̳• ◡ • ̳)ฅ  ฅ( ̳• ◡ • ̳)ฅ

 ![输入图片说明](tupian/114514.png)

 **注意事项：** 

1，云崽为免费开源项目，任何形式的盗用，造成利益的行为都是对开发者的不尊重，是种非常可耻的行为（注定没马）。

2，本教程仅仅试用于win搭建，也可以选择Linux 手机搭建，感谢🙏答疑群 **［白狐提供的教程］**[白狐姐姐教程](https://gitee.com/baihu433/Ubuntu-Yunzai?_from=gitee_search)

3，[萝莉一生安装教程目录](https://gitee.com/luoyisheng/YZhelp)

4，安装插件可去云崽专属插件库[插件库地址](https://gitee.com/yhArcadia/Yunzai-Bot-plugins-index) 

5，感谢各位大佬的不懈努力，本教程需要一点理解能力，如果你真的没有那么非常抱歉

6，有问题去答疑群虽然不一定有人给你说［836380883］

7，本教程包含三种云崽的安装方法，插件的安装，和ffmpeg等的配置项的配置
   都极为详细了不要嫌弃麻烦请认真看，再次感谢您使用本教程。

### 安装所需软件 

 **云崽懒人版本，预装 喵喵 戏天 锅巴 图鉴 插件开箱即食请下载完软件包后再看目录**

下面一键包，包含云崽所需软件，懒人版本去下面找云崽懒人版查看具体安装方法 

 **下载软件一键包，你会得到6个文件夹**
软件包地址：https://www.123pan.com/s/Hr87Vv-Wm2PH.html

注意链接可能失效，也可以更新软件我有时间会放镜像文件里

       1，ffmpeg→发送语音需要，也可以不装问题不大
       2，Git2.3.9→git下载文件和启动云崽用
       3，node.js→云崽运行环境
       4，redis-7.0.4→云崽运行所需的数据库
       5，python→主要提供NB商店插件服务，在下面自己看
       6，代码编辑器可有可无改文件方便而已

 **安装：注意可在D盘或者其他盘新建文件夹 yunzai ，文件夹建议用英文**

![输入图片说明](tupian/image.png)

 **安装redis**

这个不用安装直接拉取文件夹即可，也可以把文件夹复制或剪切到你刚刚创建的文件夹中方便管理

点击 redis-server.exe 启动

**安装完成打开运行准没错** 

![输入图片说明](tupian/image1.png)

 **安装node.js两个版本任选其一**

[node.js下载](https://nodejs.cn/download/)

注意node.js安装路径最好默认否则出现问题概不负责 

![输入图片说明](tupian/image2.png)
 
  **安装git**

[Git下载](https://pc.qq.com/detail/13/detail_22693.html)

![输入图片说明](tupian/image3.png) 

### 安装云崽本体文件

从镜像复制Yunzai-Bot文件夹，到刚刚创建的yunzai文件夹里

 **或者gitee获取：**
     
```
git clone https://gitee.com/Le-niao/Yunzai-Bot.git
```

 **在yunzai文件夹空白处长按右键然后打开 Git Bash**

![输入图片说明](tupian/tupian4.png)

打开之后复制上面的链接然后回车

![输入图片说明](tupian/image5.png)

###  **安装依赖**

进入Yunzai-Bot文件夹在空白处打开 Git Bash 输入以下命令 

 **安装pnpm安装过直接跳过**

安装指令  

```
npm install pnpm -g
```

 **安装依赖** 

安装指令 

```
pnpm install -P
```

###  **启动$关闭云崽**

 **启动命令**  

```
node app
```

 **后台关机指令**

```
pnpm stop
```

### 配置QQ号

![输入图片说明](tupian/image6.png)

 **需要登录滑条验证码请使用滑块验证APK** 

滑块验证APK下载链接：https://www.123pan.com/s/Hr87Vv-D32PH.html

 **请在手机上安装此软件，复制验证链接到手机上验证** 

![输入图片说明](tupian/image7.png)

 **复制过去直接点击下一步进行滑块验证** 

![输入图片说明](tupian/image8.png)

 **之后会得到tocket 复制下来扔进去回车即可，然后通过手机号验证就是安装成功了** 

![输入图片说明](tupian/image9.png)

 **重新登陆云崽** 

在云崽根目录打开 Git Bash 输入以下指令，即可重新配置QQ号

```
npm run login
```

### 原版出现版本过低

如果出现版本过低需要修改文件在此路径 Yunzai-Bot\data\你的机器人QQ文件夹（一般就是第一个）
在里面找到 ：device-3（机器人QQ）.json的文件夹用记事本打开
修改里面的imei（只改最后一个数字或字母格式必须一样）之后重新启动，如果失败可全改，在失败可尝试更换下列方法

尝试使用 MAC 进行登录

![输入图片说明](tupian/image10.png)

### 使用喵崽
 
现在oicq估计已经噶了推荐升级到icqq 推荐直接使用喵崽来解决登录问题，注意喵崽要配合喵喵插件使用，删除原来的云崽，
在目录里直接克隆喵崽，注意（具体安装方法可查看下方喵崽插件库链接）

 **更换喵崽**

[喵崽插件库链接](https://gitee.com/yoimiya-kokomi/Miao-Yunzai)

 **喵崽下载链接，在你新建的 yunzaiv3 文件夹打开 Git Bash 执行此命令下载** 

`git clone --depth=1 https://gitee.com/yoimiya-kokomi/Miao-Yunzai.git`

 **安装喵喵插件进入喵崽根目录（Miao-Yunzai）打开 Git Bash 输入以下命令安装**
 
 **安装喵喵插件** 

```
git clone --depth=1 https://gitee.com/yoimiya-kokomi/miao-plugin.git ./plugins/miao-plugin/
```

 **安装pnpm ，已安装的可以跳过**

使用npmjs.org安装

```
npm install pnpm -g
```

指定国内源npmmirror.com安装

```
npm --registry=https://registry.npmmirror.com install pnpm -g
```

安装依赖，直接安装

```
pnpm install -P
```

如依赖安装缓慢或失败，可尝试更换国内npm源后再执行install命令

```
pnpm config set registry https://registry.npmmirror.com
```
```
pnpm install -P
```

启动命令 

```
node app
```

### 使用喵佬已升级icqq版本

使用git下载链接

```
git clone --depth=1 -b main https://gitee.com/yoimiya-kokomi/Yunzai-Bot.git
```

注意：需要安装喵喵插件才能使用，安装方法请查看上面的（更换喵崽，从安装喵喵插件那一步开始安装即可）

### 原版登录失败更换icqq

如果想继续使用原版oicq版云崽可更换icqq协议，强烈推荐使用账号密码登录

一，篡位更换为喵喵云崽源

```
git remote set-url origin https://gitee.com/yoimiya-kokomi/Yunzai-Bot.git && git checkout main
```

二，从原先的oicq升级为icqq

```
git remote set-url origin https://gitee.com/yoimiya-kokomi/Yunzai-Bot.git && git checkout . && git pull &&  git reset --hard origin/main  && pnpm 
    install -P && npm run login
```

三，安装icqq的依赖

```
pnpm add icqq -w
```

 **如果没有提示重新登陆请执行此命令**
 
```
npm run login
```

### 最新解决icqq登录问题

icqq最新已经更新到0.6.1
在0.4.12及其以上必须使用签名API

### 关于icqq最新版签名api问题

 **签名API** 

[搭建方法](https://github.com/fuqiuluo/unidbg-fetch-qsign)

 **使用我的** 

[提取链接](https://gitee.com/maoyvna/qsign-APIl)


### 不能进行重启

 **在云崽根目录执以下命令**

```
rm -rf Yunzai-Bot/node_modules/pm2
```

```
pnpm i
```

也可以

```
rm -rf Yunzai-Bot/node_modules/pm2 && pnpm i
```

### 出现浏览器报错

 **可以降低浏览器版本** 

 **删除 puppeteer 文件** 

```
rm -rf node_modules/puppeteer
```

 **降低浏览器版本** 

```
pnpm add  puppeteer@13.7.0 -w
```

或

```
pnpm add  puppeteer@19.7.3 -w
```


 **之后重新启动一下，不行在执行下面的指令** 

```
pnpm i
```

### 使用时雨佬的gocq版云崽

 **注意事项：** 

1，同样需要安装node.js和redis安装方法请看上面

2，go-cqhttp安装有可能需要使用魔法，请确认好你的电脑到底是AMD还是ARM在进行下载

3，教程同样需要一定的理解能力，我已经写的非常清楚了，请仔细看。

4，配置项目一定要配置了在运行。

5，关闭gocq后只需要重新双击 go-cqhttp.bat 文件即可重新运行

6，go-cqhttp.bat 命令行窗口必须运行否则会寄
 
[时雨佬的项目地址及安装方法](https://gitee.com/TimeRainStarSky/Yunzai)

 **下载go-cqhttp项目地址可能需要魔法才能访问：https://github.com/Mrs4s/go-cqhttp/releases
现在由于登录协议问题只能下载 1.0.0-RC5 版本的我的电脑是AMD的所以选择AMD版本的，请根据
你的电脑版本进行选择，下载不了或者很慢就使用魔法** 

![输入图片说明](tupian/image11.png)

 **下载完会得到一个名字为go-cqhttp_windows_amd64.exe的文件双击运行
一直点确定直到命令窗口关闭**
 
![输入图片说明](tupian/image12.png)

 **然后查看刚刚的文件夹就会发现多了一个 go-cqhttp.bat 文件，我们双击运行它** 

![输入图片说明](tupian/image13.png)

 **之后输入 3回车 选择反向 Websocket 通信，之后会告诉你
默认配置文件已生成，请修改 config.yml 后重新启动，不要管直接叉掉又多了
一个 config.yml 文件双击修改它** 

![输入图片说明](tupian/image14.png)

 **修改以下四项，所有必须保持一致（目前只支持账号密码登录是不能扫描的）** 

1， uin: 账号

2， password: '密码'

3， post-format: array

4， universal: ws://localhost:2536

![输入图片说明](tupian/image15.png)

 **最后一项下拉到最下面找到 universal: ws://your_websocket_universal.server改成
这个 universal: ws://localhost:2536**
 
![输入图片说明](tupian/image16.png)

 **改完保存退出重新点击 go-cqhttp.bat 运行即可
根据提示登录即可**

![输入图片说明](tupian/image17.png)

 **之后克隆时雨佬改版后的喵崽** 

```
git clone --depth 1 https://gitee.com/TimeRainStarSky/Yunzai
```

 **装喵喵插件进入喵崽根目录（Miao-Yunzai）打开 Git Bash 输入以下命令安装** 

```
git clone --depth=1 https://gitee.com/yoimiya-kokomi/miao-plugin.git ./plugins/miao-plugin/
```

 **安装pnpm ，已安装的可以跳过**

 **使用npmjs.org安装** 

```
npm install pnpm -g
```

 **指定国内源npmmirror.com安装** 

```
npm --registry=https://registry.npmmirror.com install pnpm -g 
```

 **安装依赖，直接安装** 

```
pnpm install -P
```

 **如依赖安装缓慢或失败，可尝试更换国内npm源后再执行install命令** 

```
pnpm config set registry https://registry.npmmirror.com
```

```
pnpm install -P
```

 **启动命令** 

```
node app
```

 **gocq插件或者js报错解决办法** 

由于时雨佬完全删除了 OICQ，并且内置 segment，若插件出现缺少 OICQ，需删除 import { segment } from "oicq"
一般都在最上面的定义区

![输入图片说明](tupian/iagme18.png)

### 安装云崽的插件

请打开插件库链接 https://gitee.com/yhArcadia/Yunzai-Bot-plugins-index

![输入图片说明](tupian/image19.png)

进入一个插件找到其中的 gitee 或者 github 插件链接需要注意不要复制多了，这里推荐使用gitee
进行安装，github对网络要求较高可能需要魔法，复制链接进入云崽根目录（Yunzai-Bot）然后右键使用 Git Bash 进行安装
需要注意是否要安装依赖，还有插件安装路径是否为云崽根目录

### 云崽懒人版

下载地址：https://www.123pan.com/s/Hr87Vv-1VnPH.html

安装方法：和上面一样分别安装好 Git node.js redis 之后，记得一定要启动erdis
还有要注意node.js安装路径最好为默认。

吧下载的云崽懒人版解压放到一个你让为方便找的文件夹或者直接在磁盘
新建一个yunzai目录放里面，之后进入云崽根目录（也就是Yunzai-Bot）之后重复上面安装依赖，之后按照提示配置QQ即可。

 **云崽注意事项**
云崽启动命令是node app如果想要重新启动就在云崽根目录里输入此命令即可
数据库和Git或者cmd窗口运行的云崽是不能关的，关了云崽也就寄了
直接固定任务栏
云崽的根目录是Yunzai -Bot
大型插件目录在云崽根目录里面的piugins里面
而小型的js目录在plugins里面的example

### 安装Python

         ** 免责声明 **

          仔细看看 

      1，出现问题概不负责，请查看其他解决方法
      2，Python需要很高的理解能力，请您量力而行
      3，Python的nb插件库为：https://v2.nonebot.dev/store         
      4，python的插件安装方法请参考宵鸟佬的插件安装方法：https://gitee.com/realhuhu/py-plugin
      5，python的官网：https://www.python.org/         
      6，Python不推荐玩如果你有能力可以玩，理解能力差的就放弃吧
      7，有问题也不要找我，反正我是成功了的谢谢
      8，可以去答疑群有没有人跟你讲那咱就不知道了哦群号为［836380883］
      9，很详细了在不会我真的不知道怎么办（无能为力笨比）

![输入图片说明](https://pic4.zhimg.com/50/v2-f189f0539a1b01fc3e3975d3fcdc5a00_hd.jpg?source=1940ef5c)

### 安装方法

 **嫌麻烦的可以直接安装我镜像文件里的版本已经为您准备好了**

请不要着急安装请认真看完本教程 

![输入图片说明](tupian/image20.png)

点击进行安装，会跳出该界面因为我已经安装过了所有第一个显示没有勾选
请务必勾选第二个

![输入图片说明](tupian/image21.png)

然后点击 lnstall now 安装即可，这样你就安装好了Python，但是还远远没有结束

 **安装方法2** 

进入官网在官网下载选择合适的版本

点击第二个下载不推荐python3.11因为并不稳定可以选择
python3.10.9和3.9.10或者3.8.10

![输入图片说明](tupian/image22.png)

 **找到你想要的版本** 

![输入图片说明](tupian/image23.png)

下拉找到视窗安装程序（也就是win的安装程序）
按照电脑系统来选择32位/64位点击进行下载安装
方法同上

![输入图片说明](tupian/image24.png)

 **检查Python** 

检查Python有没有安装好，按住win键+R打开运行窗口然后输入cmd回车
也可以随便找个文件夹然后进行cmd命令

查看命令为：python -V 注意V大写看看有无输出

![输入图片说明](tupian/image25.png)

注意：cmd输入python -V查看是否安装成功，无任何输出就是没装好 
      如果python -V没反应，卸载重装，一定要勾选PATH
      注意是大写的V 如果勾上之后还没有建议重启电脑

### 克隆所需插件

分为新旧两个版本新版本大于等于3.10.9
旧版本插件较少而且以关闭旧版下载插件服务器，不过插件还是有的
不玩nb商店的可以装，新版本可以玩nb商店插件。

### 旧版python教程

 **在Yunzai-Bot目录文件下打开 Git Bash 然后输入** 

克隆插件命令：

```
git clone https://gitee.com/realhuhu/py-plugin.git ./plugins/py-plugin/
```

安装插件依赖： 

```
pnpm install @grpc/grpc-js @grpc/proto-loader -w
```

 **安装完成后进入py-plugin文件夹**
 
以下最好使用 Windows power shell 执行命令，win+R输入Windows power shell打开
长按开始菜单也是可以看到的

 **点击复制此路径** 

![输入图片说明](tupian/image26.png)

打开命令终端输入以下指令

cd\  回车 回退到最初

cd 刚刚复制到py-piugin路径回车有空格

![输入图片说明](tupian/image27.png)

 **切换清华源不换会比较慢你开心就好** 

一，

```
pip couaig set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
```

二，

```
pip config set install.trusted-host pypi.tuna.tsinghua.edu.cn
```

 **升级pip** 

```
python.exe -m pip install --upgrade pip
```

### 安装poetry

 **继续在py-piugin运行命令** 
poetryetry抱红字无法识别poetry就关掉命令行重新打开
或者使用pip install poetry  再接着poetry install

方法一：

```
pip install poetry
```

```
poetry run pip install -r requirements.txt
```

方法二：

```
poetry install
```

```
python install
```

等待安装完成即可如果启动云崽显示python服务器已关闭说明第四步没有装好，重新输入指令安装
还不行就拜拜没就了，如果还是爆红可尝试升级网络驱动或者试试别的版本。

### 新版python教程

 **和旧版差不多克隆插件**

在Yunzai-Bot目录文件下打开 Git Bash 然后输入 

```
git clone https://gitee.com/realhuhu/py-plugin.git ./plugins/py-plugin/
```

 **安装依赖（此步骤可以使用 Git Bash 安装）** 

方法一：

```
pnpm install iconv-lite @grpc/grpc-js @grpc/proto-loader -w
```

方法二要安装cnpm：

```
cnpm install iconv-lite @grpc/grpc-js @grpc/proto-loader
```

 **安装完成后进入py-plugin文件夹**
 
以下最好使用 Windows power shell 执行命令，win+R输入Windows power shell打开
长按开始菜单也是可以看到的

 **点击复制此路径** 

![输入图片说明](tupian/image28.png)

打开命令终端输入以下指令

cd\  回车 回退到最初

cd 刚刚复制到py-piugin路径回车有空格

![输入图片说明](tupian/image29.png)

 **切换清华源不换会比较慢你开心就好** 

一，

```
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
```

二，

```
pip config set install.trusted-host pypi.tuna.tsinghua.edu.cn 
```

 **升级pip**

```
python.exe -m pip install --upgrade pip
```

### 安装poetry

 **继续在py-piugin运行命令** 
poetryetry抱红字无法识别poetry就关掉命令行重新打开
或者使用
```
pip install poetry
```
再接着
```
poetry install
```

方法一：

```
pip install poetry
```

```
poetry install
```

方法二：

```
pip install poetry
```

```
poetry run pip install -r requirements.txt
```

等待安装完成即可如果启动云崽显示python服务器已关闭说明第四步没有装好，重新输入指令安装
还不行就拜拜没就了，如果还是爆红可尝试升级网络驱动或者试试别的版本。

 **［和旧版指令有区别注意看］** 

### 配置 config.yaml 

运行云崽之后在py -piugin文件夹可以找到 config.yaml 的文件夹
用记事本或者代码编辑器打开 **［此方法注意针对py插件最后启动乱码的问题］**

找到倒数第二行的 encoding：utr-8 把utr-8改成gbk（小写）然后重启云崽
出现py服务器链接成功，那么恭喜你成功。

 **py下载插件去看py帮助,和去看宵鸟佬的教程**
 
下载插件最简单的方法

#py下载插件+插件名字重启报错就py卸载插件+插件名字
示例：#py下载插件nonebot_plugin_help

 **已经很详细了在不会你真是笨比还是就不了的那种可饿** 

### 配置ffmpeg 

注意：请把此路径添加到系统环境变量中ฅ( ̳• ◡ • ̳)ฅ

我的路径是：E:\yunzai\ffmpeg\bin之需要添加到bin即可后面的无需添加

配置需要在完全配置好云崽后不然没有文件
文件目录为Yunzai-Bot\config\config\bot.yaml
分别填入 ffmpeg_path:和ffprobe_path:的绝对路径在
.....\ffmpeg\bin里面找谢谢，或者使用锅巴插件配置，添加环境变量方法自行百度 

![输入图片说明](tupian/image30.png)

**禁止私自盗取，倒卖本教程**
 
![输入图片说明](https://pic4.zhimg.com/50/v2-ea4ef7beabfab51bde15931f6e67c90a_hd.gif)

**禁止私自盗取，倒卖本教程**

![输入图片说明](https://tse2-mm.cn.bing.net/th/id/OIP-C.t-n009pPpABrjHJLZVFmYgHaHa?pid=ImgDet&rs=1)
 
**禁止私自盗取，倒卖本教程**