安装部署

在本地或服务器上部署 OpenVort。

Docker 部署（推荐）

只需安装 Docker，两行命令即可部署完整系统：

curl -fsSL https://raw.githubusercontent.com/openvort/openvort/master/docker-compose.yml -o docker-compose.yml
docker compose up -d

访问 http://localhost:10899，使用 admin / admin 登录（首次登录后要求修改密码）。

详细说明（配置、持久化、升级、从源码构建等）请参考 Docker 部署指南。

部署视频:

https://cloud.video.taobao.com/vod/6UmzaEqgXntaNmR5DRGe4hv1dvhb78xk2yA6pW7AJqE.mp4

pip 安装

需要 Python 3.11+ 和 Docker（用于自动创建数据库）。

pip install openvort
openvort start

首次启动自动创建 PostgreSQL 容器、下载前端、初始化管理员账号。访问 http://localhost:8090 登录。

从源码运行

适合开发者或想要参与贡献的用户。

git clone https://github.com/openvort/openvort.git
cd openvort
pip install -e ".[dev]"
openvort start

前端单独开发（可选）：

cd web
npm install
npm run dev   # Vite dev server，默认 http://localhost:9090

开发模式

源码开发时推荐使用 --dev 参数启动，跳过 IM 通道、ASR/TTS、Embedding 等重量级初始化，大幅加快启动速度：

openvort start --dev     # 首次启动
openvort restart --dev   # 重启

开发模式下的行为差异：

功能正常模式开发模式Web 管理面板启动启动数据库 / 插件 / 定时任务启动启动企微 / 钉钉 / 飞书通道启动跳过ASR 语音识别启动跳过TTS 语音合成启动跳过Embedding 向量服务启动跳过消息通知中心启动跳过

开发模式适合只需要 Web 面板和 API 调试的场景。如需测试 IM 通道集成，请去掉 --dev 参数正常启动。

启动后配置

首次登录使用 admin / admin，登录后会要求修改密码。

AI 功能需要在 AI 配置 页面设置 LLM API Key（支持 Anthropic Claude / OpenAI 兼容协议），其他功能开箱即用。

所有配置均为可选 — 不创建 .env 文件也能正常启动。高级用户可通过环境变量或 .env 自定义配置，详见环境变量参考。

故障排查

openvort doctor                 # 诊断系统配置和连接状态（pip 安装）
docker compose logs             # 查看所有容器日志（Docker 部署）
docker logs openvort-postgres   # 查看数据库容器日志（pip 安装）

下一步