快速安装¶
前置要求¶
- Node.js 18+ — 安装方法见 附录：环境安装
- OneBot V11 服务端 — 支持 OneBot V11 协议的 QQ 接入服务（如 NapCat、LLOneBot 等），安装方法见 附录：环境安装
- LLM API Key — 需至少一个 LLM 提供商的 API Key
脚本安装（推荐）¶
脚本会自动检查并安装 Node.js 环境。脚本本身还会自动测速选择最快的 Node.js / npm 镜像，对国内网络友好。
curl -fsSL https://raw.githubusercontent.com/spcookie/erii-distribution/refs/heads/master/scripts/install.sh | bash
irm https://raw.githubusercontent.com/spcookie/erii-distribution/refs/heads/master/scripts/install.ps1 | iex
curl -fsSL https://raw.giteeusercontent.com/spcookie/erii-distribution/raw/master/scripts/install.sh | bash
irm https://raw.giteeusercontent.com/spcookie/erii-distribution/raw/master/scripts/install.ps1 | iex
国内网络
若访问 GitHub 缓慢，请使用「国内加速」标签页的 Gitee 源。脚本下载 Node.js 与安装 npm 包时也会自动测速并优先选用国内镜像。
全局安装¶
如果你已安装 Node.js，可直接全局安装：
npm install -g erii-bot
erii setup
项目创建¶
在已有项目中创建 erii 子项目，适合需要自定义项目结构的高级用户。支持多种包管理器：
npm create erii-bot
pnpm create erii-bot
yarn create erii-bot
bun create erii-bot
安装完成后进入项目目录：
cd erii
初始化配置¶
安装完成后，运行交互式配置向导：
erii setup
向导依次引导配置 AI 模型、可选工具、QQ 连接和群组设置。
配置完成后，项目目录会生成 conf/application.conf、conf/.env.local 等配置文件。