by openvort
Open-source AI Employee Platform — Create AI employees that collaborate with your real team in WeCom, DingTalk, and Feishu, just like hiring a few more colleagues.
# Add to your Claude Code skills
git clone https://github.com/openvort/openvort>>> 在线 Demo 演示 <<< — 无需安装,立即体验
开源 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.
No comments yet. Be the first to share your thoughts!
pip install 即可扩展| AI 聊天 | AI 员工 |
|:---:|:---:|
|
|
|
| VortFlow 缺陷跟踪 | 缺陷详情 + AI 补全 |
|
|
|
用户 ──→ IM 平台 ──→ Channel 适配器 ──→ Dispatcher ──→ Agent Runtime ──→ Plugin Tools ──→ 外部系统
(企微/钉钉/飞书) │ (防抖/去重) ↕ ↕ (Gitee/Jenkins/...)
│ LLM(Claude) │
Web 面板 ─────┤ │
(Vue 3 SPA) └─────────────────────────────────────────┘
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 登录。
需要 Python 3.11+ 和 Docker。
pip install openvort
openvort start
首次启动自动创建数据库容器、下载前端、初始化管理员账号。访问 http://localhost:8090 登录。
macOS:brew install python@3.11
Ubuntu / Debian:sudo apt update && sudo apt install -y python3.11 python3.11-venv python3-pip
Windows:下载安装(勾选 "Add to PATH")
国内网络环境可使用 MIRROR=cn 参数,自动切换 apt / Node.js / pip 为国内镜像源:
docker build --build-arg MIRROR=cn -t openvort .
git clone https://github.com/openvort/openvort.git
cd openvort
pip install -e ".[dev]"
openvort start
开发模式(推荐开发者使用):
openvort start --dev # 跳过 IM 通道/ASR/TTS 等重量级初始化,启动更快
前端 HMR 开发(在另一个终端):
cd web
npm install
npm run dev # Vite dev server on :9090,/api 代理到后端 :8090
首次登录使用 admin / admin,登录后会要求修改密码。
AI 功能需要在 AI 配置 页面设置 LLM API Key(支持 Anthropic Claude / OpenAI 兼容协议),其他功能开箱即用。
openvort doctor # 诊断系统配置和连接状态(pip 安装)
docker compose logs # 查看所有容器日志(Docker 部署)
docker logs openvort-postgres # 查看数据库容器日志(pip 安装)
所有配置均为可选。不创建 .env 文件也能正常启动(数据库自动创建,AI 功能通过 Web 面板配置)。
高级用户可通过环境变量或 .env 文件自定义配置:
| 变量 | 说明 | 默认值 |
|------|------|--------|
| OPENVORT_DATABASE_URL | 数据库连接(asyncpg 格式) | postgresql+asyncpg://openvort:openvort@localhost:5432/openvort |
| OPENVORT_LOG_LEVEL | 日志级别 | INFO |
| OPENVORT_WEB_PORT | Web 面板端口 | 8090 |
| OPENVORT_WEB_DEFAULT_PASSWORD | 管理员初始密码(仅首次启动,登录后强制修改) | admin |
LLM 配置推荐通过 Web 面板的 AI 配置 页面管理(保存在数据库中),也可通过环境变量设置:
| 变量 | 说明 | 默认值 |
|------|------|--------|
| OPENVORT_LLM_API_KEY | LLM API Key | — |
| OPENVORT_LLM_PROVIDER | 提供商(anthropic / openai_compatible) | anthropic |
| OPENVORT_LLM_API_BASE | API 地址 | https://api.anthropic.com |
| OPENVORT_LLM_MODEL | 模型名称 | claude-sonnet-4-20250514 |
完整配置参考 .env.example。
企业微信:支持智能机器人长连接(推荐)/ 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/
├── cli/ # CLI 入口(start / stop / restart / doctor / marketplace / coding 等子命令)
├── core/ # 引擎核心
│ ├── engine/ # Agent Runtime / LLM Client / Session / Router
│ ├── messaging/ # Dispatcher / Commands / Pairing / Group / Inbox
│ ├── execution/ # 远程节点 / Docker 执行器 / 沙箱 / 编码环境
│ └── services/ # Scheduler / NotificationCenter / ChatMessage / Updater
├── config/ # 配置(Pydantic Settings + DB 配置服务)
├── plugin/ # 插件框架(BasePlugin / BaseTool / Registry / Loader)
├── plugins/ # 内置插件(VortFlow / VortGit / VortSketch / Jenkins / 知识库 / 汇报 / 浏览器 / 定时任务 / 系统)
├── channels/ # IM 通道(企微 / 钉钉 / 飞书 / OpenClaw,含语音工具)
├── contacts/ # 通讯录(多平台身份映射 + Service + Resolver)
├── services/ # 外部服务集成(ASR 语音识别 / TTS 语音合成 / Embedding 向量嵌入)
├── skill/ # Skill 加载器(DB 驱动四级体系)
├── marketplace/ # 扩展市场(Client + Installer,Bundle 下载/解压/安装)
├── auth/ # RBAC 权限
├── web/ # Web 面板后端(FastAPI + JWT + WebSocket + SSE + MCP Server,35 个路由模块)
└── db/ # 数据库(SQLAlchemy 2.0 async + Alembic 迁移)
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
# 开发模式
openvort start --dev # 轻量启动(跳过 IM/ASR/TTS),后端 :8090
openvort restart --dev # 轻量重启
cd web && npm run dev # 前端 HMR :9090,/api 代理到 :8090
完整的使用指南、部署教程、插件开发文档和 API 参考,请访问官方文档。
遇到问题或有好的想法?欢迎参与社区讨论。
Bug 反馈和功能请求也可以通过 GitHub Issues 提交。