项目概述

OpenMAIC（Open Multi-Agent Interactive Classroom）是清华大学 MAIC 团队开源的 AI 教育平台，核心定位是一键将任意主题或文档转化为沉浸式、交互式课堂。不同于传统 AI 对话工具的单向问答模式，OpenMAIC 引入多智能体编排机制，由 AI 教师与 AI 同学协同完成讲课、讨论、板书、出题等全流程教学动作。

核心能力

两阶段课程生成流水线

系统采用「大纲生成 → 场景内容生成」的两阶段架构。用户输入学习主题或上传参考材料后，AI 首先产出结构化课程大纲，再将每个大纲节点扩展为独立场景——幻灯片讲解、互动测验、仿真实验或项目制学习（PBL）任一形式均可自动生成。

多智能体课堂互动

由 LangGraph 状态机驱动的多智能体编排层负责调度教师 Agent 与同学 Agent 的发言轮次，支持以下四种互动模式：

• 课堂讨论：AI 主动发起话题，学生可随时插话或被点名回答
• 圆桌辩论：多个具备不同人设的 Agent 就议题展开讨论，配合白板实时图解
• 自由问答：学生提问，AI 教师以幻灯片、图表或白板绘图作答
• 实时白板：Agent 在共享白板上逐步推导公式、绘制流程图

深度交互模式（v0.2.0+）

区别于标准内容生成，深度交互模式可产出五类可操作 UI：

AI 教师可主动操作交互界面，高亮关键区域、设定实验条件、在恰当节点引导学生注意力。

快速上手

环境要求

• Node.js >= 20
• pnpm >= 10

本地部署（三步）

第一步：克隆并安装依赖

git clone https://github.com/THU-MAIC/OpenMAIC.git
cd OpenMAIC
pnpm install

第二步：配置 LLM 提供商

cp .env.example .env.local

在 .env.local 中填入至少一个大模型 API Key：

OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GOOGLE_API_KEY=...

项目支持的提供商覆盖 OpenAI、Anthropic、Google Gemini、DeepSeek、通义千问、Kimi、MiniMax、Grok、Doubao、腾讯混元、小米 MiMo、智谱 GLM、Ollama（本地）等，以及任意 OpenAI 兼容接口。

推荐模型： Gemini 3 Flash——质量与速度的最佳平衡点。追求最高质量可选 Gemini 3.1 Pro。

第三步：启动开发服务

pnpm dev

访问 http://localhost:3000 即可使用。

生产环境构建

pnpm build && pnpm start

Docker 部署

cp .env.example .env.local
# 编辑 .env.local 填入 API Keys
docker compose up --build

一键 Vercel 部署

点击仓库页面的「Deploy with Vercel」按钮，填入环境变量（至少一个 LLM Key）即可完成云端部署，无需本地环境。

进阶配置

本地 AI 支持（Lemonade）

如需完全离线运行，可集成 Lemonade 作为本地提供商，涵盖 LLM 推理、图像生成、TTS 与 ASR，无需 API Key：

LEMONADE_BASE_URL=http://localhost:13305/v1
TTS_LEMONADE_BASE_URL=http://localhost:13305/v1
ASR_LEMONADE_BASE_URL=http://localhost:13305/v1
IMAGE_LEMONADE_BASE_URL=http://localhost:13305/v1

语音克隆 TTS（VoxCPM2）

集成 OpenBMB 的 VoxCPM2 开源 TTS 模型，支持三种声音模式：

• Auto Voice：系统根据 Agent 人设自动生成声线，无需配置
• Prompt Voice：以自然语言描述声线风格，例如「温柔女性教师音，平和鼓励，中音调」
• Clone Voice：上传或录制参考音频，实现声音克隆

在设置面板「文字转语音 → VoxCPM2」中填入本地服务地址即可启用：

TTS_VOXCPM_BASE_URL=http://localhost:8000/v1

高级文档解析（MinerU）

针对含复杂表格、公式、扫描件的 PDF，可接入 MinerU 提升解析精度：

PDF_MINERU_BASE_URL=https://mineru.net/v1  # 或自托管地址
PDF_MINERU_API_KEY=...

访问控制

共享部署时可设置站点密码：

ACCESS_CODE=your-secret-code

导出与离线支持

生成完毕的课堂内容可通过以下格式导出：

离线导出时，系统会将 KaTeX、Three.js、Tailwind CDN 等外部资源内嵌为 data: URI，确保课堂在断网环境下完整播放。

应用场景

OpenMAIC 的适用范围覆盖个人学习与团队知识传递的多个维度：

个人自学：告诉系统「30 分钟从零学 Python」，系统自动生成完整的结构化课程并配合互动练习。

学术研究理解：上传论文 PDF，系统将其拆解为多场景可视化课程，AI 教师逐节讲解关键思路。

企业培训：将产品手册、规章制度或技术文档转化为带测验的互动培训课程，支持离线部署与访问控制。

STEM 教学：物理仿真、数学推导白板、在线编程实验可即时生成，无需额外搭建实验环境。

聊天工具集成（OpenClaw）：通过 clawhub install openmaic 安装技能后，直接在飞书、Slack、Telegram 等 IM 工具中发送指令即可触发课堂生成，无需打开浏览器。

项目信息

OpenMAIC 将 AI 从对话工具升级为主动教学系统，其多智能体架构与深度交互模式代表了当前开源 AI 教育工具的前沿实践。对于有内容教学需求的个人、团队或机构而言，值得重点关注与试用。