SenteLabsAI/OpenExecutive · 上手攻略

  • 仓库:SenteLabsAI/OpenExecutive
  • 链接:https://github.com/SenteLabsAI/OpenExecutive
  • 分类:AI · 多智能体 · 企业应用
  • 作者:Jay
  • 更新:2026-09-06

这是什么

OpenExecutive 是一个 AI 虚拟高管团队系统——用一套系统扮演你公司的完整高管层(CSO、CFO、CHRO、GC、COO、CMO、CPO、董事会秘书),用户始终只和一个连贯的"Executive"声音对话,内部则由 8 个专业 Agent 并行协作,从 ChromaDB 检索知识、SQLite 记录决策记忆、Anthropic Claude 作为底层模型驱动。

sentelabs.ai 开发,Apache 2.0 开源,核心技术栈:Python 3.11 + FastAPI(后端)+ Next.js 15(前端)+ ChromaDB(向量知识库)+ SQLite(记忆/审计)+ Anthropic Claude API。

解决什么问题

  • 单一入口、多专协作:不需要分别找 CFO 问财务、找 CMO 问营销,一个对话入口,Executive 自动判断该调动哪些专家
  • 企业知识 RAG:内置 MBA 级知识库(git-tracked Markdown),同时支持上传你自己的公司文档,两者都注入到每次专家咨询的上下文中
  • 跨会话记忆:每轮对话后,系统用 claude-haiku-4-5 提取关键决策和行动项存入 SQLite,下次对话时自动携带 <past_decisions> 上下文
  • 主动提醒:内置 Scheduler 会在适当时间主动推送待办和提醒
  • Prompt 缓存优化:系统提示词结构化缓存,实践测得 85% 缓存命中率,显著降低 token 消耗
  • Discord 机器人:开箱即用的 Discord 集成,可以直接在 Discord 频道里问高管团队问题

快速安装

前置要求

  • Python 3.11+
  • Node.js 22+(用于 Next.js 前端)
  • Anthropic API Keysk-ant-...
  • uv(推荐,Fast 包管理器)
  • make(可选,纯手动也支持)

步骤一:克隆代码

git clone https://github.com/SenteLabsAI/OpenExecutive.git
cd OpenExecutive

步骤二:配置环境变量

cp .env.example .env
# 编辑 .env,填入:
# ANTHROPIC_API_KEY=sk-ant-...
# 如需 Google 登录(Web UI),还需填 AUTH_* 相关字段

步骤三:启动

make dev

这会同时启动: - API 服务 → http://localhost:8000 - Web UI → http://localhost:3000

首次启动耗时:需要拉取 ML 依赖(ChromaDB + sentence-transformers / PyTorch),还会下载约 90 MB 的 embedding 模型构建本地向量索引,首次 make dev 需要几分钟,后续启动秒开。

不用 make 的手动方式

# 后端
cd packages/core
uv sync
source .venv/bin/activate
uvicorn openexecutive.api.main:app --reload --port 8000

# 前端(另一终端)
cd packages/ui
npm install
npm run dev

Docker 部署

cd OpenExecutive
docker compose up -d
# 访问 http://localhost:3000

核心用法

核心架构

你的消息
    ↓
Executive Orchestrator(claude-sonnet-4-6)
    ↓ tool use(并行调用专家)
CSO / CFO / CHRO / GC / COO / CMO / CPO / Board
    ↓ 各专家从 ChromaDB 检索上下文
内置 MBA 知识库 + 你上传的公司文档
    ↓
合成后的单一高管声音返回给你

8 个专家 Agent

Agent 职能范围 默认模型 何时启用
CSO(首席战略官) 竞品分析、M&A、市场定位、OKR claude-opus-4-7 + 深度推理 战略/竞争/并购相关问题
CFO(首席财务官) 财务建模、融资、单位经济、现金流 claude-opus-4-7 + 深度推理 财务/融资/预算问题
CHRO(首席人力官) 招聘、薪酬、绩效、文化 claude-sonnet-4-6 人力/组织问题
GC(总法律顾问) 合同、知识产权、劳动法、合规 claude-opus-4-7 + 深度推理 法律/合规相关问题
COO(首席运营官) 流程设计、供应商管理、运营扩展 claude-sonnet-4-6 运营/流程问题
CMO(首席营销官) GTM 策略、品牌、传播、公关 claude-sonnet-4-6 市场/品牌/营销问题
CPO(首席产品官) 路线图、优先级、产品战略 claude-sonnet-4-6 产品/功能/路线图问题
Board(董事会秘书) 董事会演示、投资人关系、治理 claude-opus-4-7 + 深度推理 董事会/投资人材料

内部路由通过 consult_specialist 工具实现,不是硬编码逻辑,是模型自己决定何时调用哪位专家。

Discord 机器人

  1. Discord Developer Portal 创建应用,开启 Message Content privileged intent
  2. bot + applications.commands scopes 邀请机器人
  3. .env 设置: bash DISCORD_BOT_TOKEN=xxx DISCORD_APP_ID=xxx
  4. 重启服务后,在 Discord 频道 @你的机器人 即可提问

Prompt 缓存机制

系统提示词被拆分为三个独立缓存块(Executive 人设 / 公司档案 / 知识索引),用户对话在几轮后缓存命中率达到 85%,显著降低每次请求成本。动态内容永远不会进入缓存块

Scheduler 注意事项

Scheduler 通过 UPDATE … RETURNING 原子操作防止重复触发。API 必须以单实例运行;水平扩展前必须先实现调度器分布式锁,否则会导致重复执行。

典型适用场景

  1. 创业公司模拟高管团队:没有足够的预算请各领域高管,问战略问题调 CSO,问融资问题调 CFO
  2. 企业决策辅助:上传你自己的公司文档和财务数据,系统结合你的实际上下文给出建议
  3. 跨部门协调:一个对话入口解决原本需要分别找 CFO(要数字)、COO(要流程)的碎片化沟通
  4. 董事会材料生成:Board Agent 专攻董事会演示和投资人材料,自动化生成初稿
  5. Discord 运营团队:直接在 Discord 频道里问高管问题,不需要切换工具

坑与注意

  1. ⚠️ API 必须单实例运行:Scheduler 的 UPDATE … RETURNING 防重机制依赖单实例,水平扩展前必须加分布式锁,这是官方明确说明的架构约束。
  2. ⚠️ 首次启动耗时长:embedding 模型下载(~90 MB)+ ChromaDB 初始化,首次 make dev 可能需要 3-5 分钟,不是卡住了,耐心等待即可。
  3. Python 3.11+ 强制:不支持 Python 3.10 及以下,uv sync 会直接报错。
  4. 公司文档 RAG 是启动时加载:上传新公司文档后需要重启服务(或重启知识库加载),不会热更新。
  5. embedding 模型本地存储:ChromaDB 的 embedding 模型存储在本地磁盘,如果换机器需要重新构建索引。
  6. Google 登录需要额外配置:Web UI 的 Auth.js Google 登录需要在 Google Cloud Console 创建 OAuth 2.0 凭据,参见 docs/auth.md
  7. Discord 机器人需要 Message Content Intent:Discord 2023 年后新增要求,必须在 Developer Portal 手动开启,否则机器人收不到消息。
  8. Anthropic API 成本:8 个专家并行调用,每次对话实际触发多次 API 调用(Executive + 所选专家),prompt caching 能显著优化但首次对话成本仍较高。

与同类对比

方案 定位 优点 缺点
OpenExecutive 虚拟高管团队,8 专业 Agent 并行 单入口、多专家、RAG+记忆、支持 Discord 需要自己部署、Anthropic API 成本
AutoGen / Microsoft Copilot Studio 企业级多 Agent 框架 与 Microsoft 生态集成、成熟 配置复杂、非专为高管场景设计
CrewAI 多 Agent 编排框架 简单易用、开源 需要自己搭高管知识库和记忆层
Notion AI / ChatGPT Team 单助手 即用、无需部署 多专家串行、无企业记忆

OpenExecutive 的差异化在于:高管专属知识库(RAG)+ 跨会话记忆(SQLite)+ 主动 Scheduler,三者合一让 AI 不只是问答工具,而是能"记住你公司决策"的持续性顾问。

一句话推荐结论

如果你需要的是一个能记住你公司背景、调动多个专业领域、自动追踪决策行动项的 AI 高管顾问团队,且有 Anthropic API 预算,OpenExecutive 是目前开源领域最完整的高管 Agent 解决方案。