首次初始化向导

部署完成后的首次启动——AI 引导你完成系统初始化。

概述

OpenVort 部署启动后，首次访问 Web 面板时会自动进入初始化向导。这个过程由 AI 引导完成，你不需要手动编辑配置文件。

初始化流程

1. 访问 Web 面板

打开浏览器访问 http://localhost:8090，系统检测到未初始化，自动进入向导页面。

2. AI 引导对话

向导以对话形式进行。AI 会依次询问：

AI: 你好！欢迎使用 OpenVort。我来帮你完成首次设置。

    首先，请告诉我你的名字？

用户: 张强

AI: 好的，张强。你的手机号或邮箱是？（用于登录和通知）

用户: 13800138000

AI: 收到。接下来给你的 AI 助手取个名字吧。
    这是你的首个 AI 员工，它会帮你处理日常工作。

用户: 就叫小 V 吧

AI: 小 V，好名字！你希望小 V 是什么风格？
    比如：专业严谨、轻松活泼、简洁高效...

用户: 简洁高效

AI: 初始化完成！
    - 管理员账号：张强
    - 默认密码：openvort（建议尽快修改）
    - AI 助手：小 V（简洁高效风格）

    你可以开始使用了。试试在聊天窗口和小 V 说句话？

3. 初始化完成后

系统会：

  • 创建管理员 Member，分配 admin 角色
  • 保存 AI 人设到配置文件
  • 标记系统已初始化（后续启动不再进入向导）
  • 自动跳转到正常的 Web 面板

跳过向导

如果不需要 AI 引导，也可以直接通过环境变量或 CLI 完成初始化：

CLI 初始化

openvort init

交互式命令行引导，依次配置 LLM API Key、数据库、IM 通道等。

环境变量初始化

在 .env 中配置好所有必要变量后直接启动：

openvort start --web

系统会使用默认设置完成初始化。

初始化后的下一步

  1. 配置 LLM — 在系统设置中填入 API Key（如果初始化时未配）
  2. 连接 IM 通道 — 配置企微/钉钉/飞书
  3. 同步通讯录 — 从 IM 平台导入团队成员
  4. 创建 AI 员工 — 根据团队需要创建更多 AI 员工