云崽机器人安装指南

YUNZAI BOT SETUP

  • 科室：结构科
  • 编目范围：持续更新
  • 相关人物：SeaSmall
  • 访问范围：OPEN ARCHIVE

云崽 (Yunzai-Bot) 是一款基于 Node.js 的 QQ 机器人框架，拥有庞大的插件生态，易于上手。

📱 手机 Termux 安装

下载 Termux

从官网或资源站下载并安装 Termux。

安装 Ubuntu 容器

在 Termux 终端中依次输入：

curl -sL https://wintersea.cn/ziyuan/sh/u.sh | bash
./ubuntu.sh

运行云崽脚本

等待 Ubuntu 安装完成后：

./u.sh
bash ./first.sh
cd ~
bash <(curl -sL https://wintersea.cn/ziyuan/sh/SeaSmall_Shell.sh)
1

启动云崽

source ~/.bashrc
yz

现在开始配置你的账号吧！

🖥️ Ubuntu 电脑/服务器安装

打开命令行，使用 sudo -i 进入 root 目录，然后运行脚本：

bash <(curl -sL https://wintersea.cn/ziyuan/sh/SeaSmall_Shell.sh)
1
source ~/.bashrc
yz

💻 Windows 电脑安装

安装基础软件

在资源目录下载并安装 Node.js、Git、Redis。

克隆项目

在目标文件夹右键选择 Git Bash Here，输入：

git clone --depth 1 -b main https://gitee.com/Le-niao/Yunzai-Bot.git
npm config set registry https://registry.npmmirror.com
npm install pnpm -g

安装依赖并启动

cd Yunzai-Bot
pnpm config set puppeteer_download_host=https://npmmirror.com/mirrors
pnpm install -P
node app

❓ 常见问题

如何重启机器人？

  • 手机版：打开终端 → ./u.sh 进入 Ubuntu → 输入 yz
  • Ubuntu：sudo -i 进入 root → 输入 yz
  • Windows：运行 Redis Server → 到云崽目录 → node app

登录失败，错误码 45

进入云崽根目录，运行 npm run login，在设备选择处更换其他协议尝试。

本文来自 SeaSmall 个人博客的既有文档，内容版权归 SeaSmall 所有。