> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneee.cn/llms.txt
> Use this file to discover all available pages before exploring further.
# 快速开始
> 5 分钟完成 PAI 本地部署，开始你的第一次对话
## 前置条件
在开始之前，请确保你的机器已安装以下软件：
Docker Engine 20.10 及以上版本
Docker Compose v2 及以上版本
推荐使用 [Docker Desktop](https://www.docker.com/products/docker-desktop)，它已内置 Docker Compose。
***
## 部署步骤
```bash theme={null}
git clone https://github.com/Lsogod/personal-ai-pai.git
cd personal-ai-pai
```
复制示例配置文件并填写必要参数：
```bash theme={null}
cp .env.example .env
```
打开 `.env` 文件，至少需要设置以下变量：
```dotenv theme={null}
# 必填：OpenAI API 密钥
OPENAI_API_KEY=sk-your-api-key-here
# 必填：JWT 密钥（用于用户认证，可随机生成）
JWT_SECRET=your-random-secret-string
# 必填：管理员 Token（用于后台管理接口）
ADMIN_TOKEN=your-admin-token
```
请妥善保管你的 API 密钥和 Token，不要将 `.env` 文件提交到公开仓库。
使用 Docker Compose 一键启动所有服务：
```bash theme={null}
docker-compose up -d
```
首次启动会自动拉取镜像并初始化数据库，可能需要几分钟时间。你可以通过以下命令查看启动日志：
```bash theme={null}
docker-compose logs -f
```
启动的服务包括：后端 API 服务、PostgreSQL 数据库、Redis 缓存，以及 Web 前端。
服务启动完成后，打开浏览器访问：
```
http://localhost:3001
```
你将看到 PAI 的 Web 聊天界面。
在聊天框中输入你的第一条消息，例如：
```
你好，请介绍一下你自己
```
PAI 会通过流式响应实时回复你。你可以尝试以下功能：
```
今天天气怎么样？
帮我写一封邮件草稿
```
```
今天午餐花了 35 元
这个月花了多少钱？
```
```
明天下午 3 点提醒我开会
这周有什么安排？
```
发送一张图片，PAI 会自动识别并描述图片内容。
***
## 接入平台（可选）
完成基础部署后，你可以进一步接入即时通讯平台：
配置 Bot Token 即可接入
通过 GeWeChat 接入个人微信
通过 OneBot 协议接入 QQ
接入飞书开放平台
微信小程序原生接入
已随部署自动启动
***
## 常见问题
请检查 Docker 容器是否正常运行：
```bash theme={null}
docker-compose ps
```
确保所有服务状态为 `Up`。如果有服务启动失败，查看对应日志排查问题。
请确认 `OPENAI_API_KEY` 已正确配置，且 API 密钥有效。查看后端日志：
```bash theme={null}
docker-compose logs -f backend
```
```bash theme={null}
git pull origin main
docker-compose up -d --build
```
***
## 下一步
了解所有环境变量的详细说明
深入理解 PAI 的多节点 Router 架构