快速开始

本指南帮助你在 5 分钟内完成 ChatAI 插件的安装和基础配置。

环境要求

依赖	版本要求	说明
Node.js	18.0+	推荐使用 LTS 版本
pnpm	8.0+	包管理器
Yunzai-Bot	V3	Miao-Yunzai 或 TRSS-Yunzai

安装步骤

1. 克隆插件

在 Yunzai-Bot 根目录执行：

git clone https://github.com/XxxXTeam/chatai-plugin.git ./plugins/chatai-plugin

2. 安装依赖

pnpm install

3. 构建原生模块

插件使用 better-sqlite3 作为本地数据库，需要构建原生模块：

pnpm rebuild better-sqlite3

提示

如果构建失败，请确保已安装编译工具：

• Windows: 安装 Visual Studio Build Tools
• Linux: sudo apt install build-essential python3
• macOS: xcode-select --install

4. 启动服务

pnpm start
# 或
node app

首次配置

获取管理面板

启动成功后，向机器人发送：

#ai管理面板

机器人会私聊发送一个临时登录链接，点击即可进入 Web 管理面板。

永久链接

发送 #ai管理面板 永久 可获取永久登录链接（需妥善保管）

初始化向导

首次进入面板会自动弹出初始化引导向导：

步骤	操作	说明
1	选择渠道	从预设渠道选择或手动配置
2	填写 API Key	输入你的 API 密钥
3	测试连接	验证配置是否正确
4	选择模型	获取可用模型列表
5	选择预设	选择 AI 人格
6	配置触发	设置触发前缀

免费体验

选择 OpenEL 免费渠道 可直接体验，无需 API Key

开始对话

配置完成后，使用设置的触发方式与 AI 对话：

#chat 你好，请介绍一下自己

或在群内 @机器人：

@机器人 今天天气怎么样？

常用命令

命令	说明
#ai管理面板	获取管理面板链接
#结束对话	结束对话并清除上下文
#清除记忆	清除个人记忆数据
#ai状态	查看插件运行状态

下一步

• 安装部署 - 详细的安装说明
• 基础配置 - 了解配置选项
• 多渠道配置 - 配置多个 API 渠道