OpenVort

官网 | 文档 | 扩展市场 | 社区

开源 AI 员工平台 — 创建 AI 员工，让他们与真人一起在企业微信、钉钉、飞书里协作，就像多招了几个同事。

Open-source AI Employee Platform — Create AI employees that work alongside your real team in WeCom, DingTalk, and Feishu — taking requirements, writing code, reviewing PRs, running builds, and generating reports, just like hiring a few more colleagues.

特性

• AI 驱动 — 基于 Claude tool use 的 agentic loop，Agent 自主决策调用工具，支持多模型 Failover
• AI 员工 — 虚拟成员绑定岗位与 Skill，通过定时任务自动执行日报/代码审查/测试等工作；支持一键创建 Docker 工作电脑，在自己的环境里写代码、跑脚本、装工具
• 异步任务执行 — Agent 执行与 SSE 解耦，用户离开页面 AI 继续工作；任务完成后自动通知；支持从任意页面查看进度、中断或追加指令
• 消息通知系统 — Chat 为消息归宿，IM 为门铃：实时 WebSocket 推送未读红点、声音/Toast/桌面通知、Tab 标题计数；延迟检测已读后按用户偏好 IM 通道优先级发送简短提醒；通知聚合 + 免打扰时段
• 多 IM 支持 — 企业微信、钉钉、飞书、OpenClaw 多平台网关，支持语音消息收发（ASR/TTS）
• Web 管理面板 — Vue 3 + FastAPI，支持 AI 聊天（SSE 流式）、概览仪表盘、AI 配置中心、项目管理、代码仓库、知识库、汇报、定时任务、通知中心等
• 插件化架构 — Plugin 是 OpenVort 的核心扩展单元，Channel（IM 通道）和 Plugin（Tool + Prompt）均可插拔，pip install 即可扩展
• 内置 10 个插件 — 禅道、VortFlow 敏捷流程、VortGit 代码仓库、Jenkins CI/CD、知识库（RAG）、汇报管理、定时任务、浏览器自动化、系统管理
• Skill 知识注入 — 四级 Skill 体系（内置/公共/个人/市场），7 个内置 Skill 按岗位自动映射
• 扩展市场 — 统一的 Skill + Plugin 市场，支持 Bundle（zip）上传、PyPI 包、CLI 一键发布，SHA-256 内容 Hash 自动检测更新
• 安全 — RBAC 四级权限、DM 配对、Docker 沙箱、Token 加密

架构

用户 ──→ 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）	anthropic
OPENVORT_DATABASE_URL	数据库连接	PostgreSQL（本地开发）
OPENVORT_LOG_LEVEL	日志级别	INFO
OPENVORT_WEB_PORT	Web 面板端口	8090
OPENVORT_WEB_DEFAULT_PASSWORD	成员默认登录密码	openvort
OPENVORT_MARKETPLACE_ENABLED	是否启用扩展市场	true

完整配置参考 .env.example。

IM 通道配置

企业微信：支持智能机器人长连接（推荐）/ Webhook。配置 OPENVORT_WECOM_* 系列变量。

钉钉：推荐 Stream 长连接模式，配置 OPENVORT_DINGTALK_APP_KEY、OPENVORT_DINGTALK_APP_SECRET、OPENVORT_DINGTALK_ROBOT_CODE。流式输出额外配置 OPENVORT_DINGTALK_MESSAGE_TYPE=card + 卡片模板。

飞书：推荐 WebSocket 长连接模式，配置 OPENVORT_FEISHU_APP_ID、OPENVORT_FEISHU_APP_SECRET。

OpenClaw：多平台网关（WhatsApp/Telegram/Slack/Discord），配置 OPENVORT_OPENCLAW_GATEWAY_URL、OPENVORT_OPENCLAW_HOOK_TOKEN。

项目结构

src/openvort/
├── core/           # 引擎核心（Agent Runtime / LLM Client / Session / Dispatcher / 远程节点 / TaskRunner 异步执行 / NotificationCenter 通知中心 / 升级服务）
├── config/         # 配置（Pydantic Settings + DB 配置服务）
├── plugin/         # 插件框架（BasePlugin / BaseTool / Registry / Loader）
├── plugins/        # 内置插件（禅道 / VortFlow / VortGit / Jenkins / 知识库 / 汇报 / 浏览器 / 定时任务 / 系统）
├── channels/       # IM 通道（企微 / 钉钉 / 飞书 / OpenClaw，含语音工具）
├── contacts/       # 通讯录（多平台身份映射 + Service + Resolver）
├── services/       # 外部服务集成（ASR 语音识别 / TTS 语音合成 / Embedding 向量嵌入）
├── skill/          # Skill 加载器（DB 驱动四级体系）
├── skills/         # 内置 Skill 文件（7 个 SKILL.md）
├── marketplace/    # 扩展市场（Client + Installer，Bundle 下载/解压/安装）
├── auth/           # RBAC 权限
├── web/            # Web 面板后端（FastAPI + JWT + WebSocket + SSE，28 个路由模块）
├── db/             # 数据库（SQLAlchemy 2.0 async + Alembic 迁移）
└── cli.py          # CLI 入口（含 marketplace publish/sync 命令）

web/                # 前端（Vue 3.5 + TypeScript 5.9 + Vite 7 + Tailwind CSS 4）

详细架构设计参见官方文档。

扩展市场

从扩展市场安装和发布 Skill/Plugin。浏览社区发布的 Skill 和插件，或将你的作品分享给其他用户。

安装扩展

# 安装 Skill
openvort marketplace install skill author/my-skill

# 安装 Plugin（支持 Bundle 和 PyPI 两种方式）
openvort marketplace install plugin author/my-plugin

发布扩展

# 发布本地文件夹（自动检测类型、打包上传）
openvort marketplace publish ./my-extension

# 指定类型
openvort marketplace publish ./my-plugin --type plugin

Skill Bundle 应包含 SKILL.md（核心内容），Plugin Bundle 应包含完整的插件代码。可选的 manifest.json 用于定义元数据。

管理扩展

openvort marketplace search "keyword"    # 搜索
openvort marketplace list                # 列出已安装
openvort marketplace sync --all          # 同步更新（对比版本+Hash）
openvort marketplace uninstall slug      # 卸载

开发命令

make install   # pip install -e ".[dev]"
make dev       # openvort start
make test      # pytest -v
make lint      # ruff check
make format    # ruff format

文档

完整的使用指南、部署教程、插件开发文档和 API 参考，请访问官方文档。

• 快速开始 — 安装、配置、首次运行
• AI 员工 — 创建和管理 AI 员工
• 插件开发 — 开发自定义插件
• 部署指南 — Docker 部署、Nginx 配置、生产环境
• API 参考 — REST / WebSocket / SSE 接口

社区

遇到问题或有好的想法？欢迎参与社区讨论。

• 提问求助、分享使用经验
• 提交功能建议
• 发布教程和最佳实践

Bug 反馈和功能请求也可以通过 GitHub Issues 提交。

协议

AGPL-3.0