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/openvortLast scanned: 5/19/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-19T07:46:32.458Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": true
}openvort is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built 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. It has 447 GitHub stars.
Yes. openvort passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/openvort/openvort" and add it to your Claude Code skills directory (see the Installation section above).
openvort is primarily written in Python. It is open-source under openvort on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh openvort against similar tools.
No comments yet. Be the first to share your thoughts!
>>> 在线 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.
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 登录。
没有 Docker?macOS / Windows / Linux:
curl -fsSL https://get.docker.com | sudo sh
需要 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 提交。