架构

用户 ──→ IM 平台 ──→ Channel 适配器 ──→ Dispatcher ──→ Agent Runtime ──→ Plugin Tools ──→ 外部系统
     (企微/钉钉/飞书)   │                  (防抖/去重)     ↕    ↕              (禅道/Gitee/...)
                        │                            LLM(Claude)  │
          Web 面板 ─────┤                                         │
         (Vue 3 SPA)    └─────────────────────────────────────────┘

快速开始

本地开发

# 克隆仓库
git clone https://github.com/openvort/openvort.git
cd openvort

# 安装后端（editable 模式）
pip install -e ".[dev]"

# 复制并编辑环境变量
cp .env.example .env
# 至少配置 OPENVORT_LLM_API_KEY

# 启动（后端 + Web 面板）
openvort start --web

Docker 部署

# 复制并编辑环境变量
cp .env.example .env

# 一键启动（含 PostgreSQL）
docker compose up -d

默认端口 8090，访问 http://localhost:8090 进入 Web 管理面板。

前端单独开发

cd web
npm install
npm run dev   # Vite dev server，默认 http://localhost:9090，/api 代理到 8090

环境变量

| 变量 | 说明 | 默认值 | |------|------|--------| | OPENVORT_LLM_API_KEY | LLM API Key（必填） | — | | OPENVORT_LLM_MODEL | 模型名称 | claude-sonnet-4-20250514 | | OPENVORT_LLM_PROVIDER | 提供商（anthropic / openai_compatible） | `anth...