OpenMAIC

OpenMAIC（Open Multi-Agent Interactive Classroom）是清华大学开源的AI互动课堂平台，能将任意主题或文档转化为丰富的交互式学习体验，生成的课程体验完整、效果优异。基于多智能体协作引擎，它可自动生成演示幻灯片、测验、交互式模拟实验和项目制学习活动——由AI教师和AI同学完成语音讲解、白板绘图，并与用户展开实时讨论；内置OpenClaw集成后，还能直接在飞书、Slack、Telegram等聊天应用中生成课堂。

生成的课堂内容包含：

• 课程介绍PPT（搭配Banana生成的配图）
• 旁白语音讲解，讲解时会高亮对应内容
• 课后测评，自动生成题目考查学习效果

学习过程中可随时提问，提问后AI教师会解答问题，同时在白板展示讲解内容；随后多个AI同学会围绕问题展开讨论，AI教师再进一步讲解，最后还会要求用户发言，整体交互高度拟人、趣味性强。

核心亮点

• 一键生成课堂：描述学习主题或上传学习材料，AI几分钟内即可构建完整课堂
• 多智能体课堂：AI老师和智能体同学实时授课、讨论、互动，还原真实课堂场景
• 丰富的场景类型：覆盖幻灯片、测验、HTML交互式模拟、项目制学习（PBL）等形式
• 白板 & 语音：智能体可实时绘制图表、书写公式，并进行语音讲解
• 灵活导出：支持下载可编辑的.pptx幻灯片或交互式.html网页
• OpenClaw 集成：通过AI助手在飞书、Slack、Telegram等20+聊天应用中直接生成课堂

Tip：OpenClaw — 在聊天应用中零配置使用OpenMAIC

通过OpenClaw可直接在飞书、Slack、Discord、Telegram等20+聊天应用中生成课堂，操作步骤：

1. 执行clawhub install openmaic，或直接对Claw说"安装 OpenMAIC skill"
2. 选择使用模式：
   • 托管模式：在open.maic.chat获取访问码，无需本地部署
   • 本地部署：Skill会引导逐步完成clone、配置和启动
3. 向助手发送指令（如"教我量子物理"），即可生成课堂

快速开始

环境要求

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

1. 克隆 & 安装

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

2. 配置

cp .env.example .env.local

至少填写一个LLM服务商的API Key：

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

也可通过server-providers.yml配置服务商：

providers:
  openai:
    apiKey: sk-...
  anthropic:
    apiKey: sk-ant-...

支持的服务商：OpenAI、Anthropic、Google Gemini、DeepSeek及任何兼容OpenAI API的服务。
推荐模型：Gemini 3 Flash（效果与速度平衡）；追求高质量可选Gemini 3.1 Pro（速度较慢）。
若希望服务端默认使用Gemini，需额外设置DEFAULT_MODEL=google:gemini-3-flash-preview。

3. 启动

pnpm dev

打开http://localhost:3000即可开始使用！

4. 生产环境构建

pnpm build && pnpm start

Vercel 部署

1. Fork本仓库
2. 导入到Vercel
3. 配置环境变量（至少一个LLM API Key）
4. 完成部署

Docker 部署

cp .env.example .env.local
# 编辑.env.local填入API Key后执行：
docker compose up --build

可选：MinerU（增强文档解析）

MinerU可提升表格、公式和OCR解析能力，可使用官方API或自行部署，需在.env.local中设置：

PDF_MINERU_BASE_URL=...
# 如需认证补充设置：
PDF_MINERU_API_KEY=...

✨ 功能特性

课堂生成

描述学习内容或上传参考材料，OpenMAIC通过两阶段流水线自动构建课堂：

课堂组件

• 🎓 幻灯片（Slides）：AI老师配合聚光灯和激光笔动作进行语音讲解，还原真实课堂体验
• 🧪 测验（Quiz）：支持单选/多选/简答类交互式测验，AI实时判分并给出反馈
• 🔬 交互式模拟（Interactive）：基于HTML的交互实验，适用于物理模拟器、流程图等可视化学习场景
• 🏗️ 项目制学习（PBL）：用户选择角色后，与AI智能体协作完成含里程碑和交付物的结构化项目

多智能体互动

• 课堂讨论：智能体主动发起讨论话题，用户可随时加入或被点名互动
• 圆桌辩论：多个不同人设的智能体围绕话题讨论，并配合白板讲解
• 自由问答：随时提问，AI老师通过幻灯片、图表或白板解答
• 白板：AI智能体在共享白板实时绘图，逐步推导方程、绘制流程图讲解概念

OpenClaw 集成

OpenMAIC集成OpenClaw（连接飞书、Slack、Discord等消息平台的个人AI助手），可直接在聊天应用中生成和查看互动课堂，无需操作命令行：

• 托管模式：在open.maic.chat获取访问码并保存到配置文件，无需本地部署
• 本地部署模式：Skill引导完成clone、安装依赖、配置API Key、启动服务
• 跟踪进度：自动轮询异步生成任务，完成后发送课堂链接
• 操作确认：每一步均征求用户确认，无黑盒执行

已上架ClawHub，一行命令安装：

clawhub install openmaic

或手动安装：

mkdir -p ~/.openclaw/skills
cp -R /path/to/OpenMAIC/skills/openmaic ~/.openclaw/skills/openmaic

导出功能

更多功能

• 语音合成（TTS）：支持多种语音服务商，可自定义音色
• 语音识别：通过麦克风与AI老师对话
• 网络搜索：智能体在课堂中搜索网络获取最新信息
• 国际化：界面支持中文和英文
• 暗色模式：适配深夜学习场景