1. 项目定位与用途
OpenMAIC 是一个开源的多智能体互动课堂平台，定位为 AI 驱动的教育内容生成与交互系统。其核心用途是通过自动化技术将任意主题或文档转化为完整的互动课程，包括幻灯片讲解、知识测验、交互式模拟和项目式学习活动。平台由 AI 教师和 AI 同学共同组成多智能体系统，能够实时授课、参与讨论、在白板上可视化内容，并通过语音合成进行讲解，为用户提供沉浸式的学习体验。所有生成内容均可导出为可编辑的 PPTX 文件或独立的交互式 HTML 页面，便于分享和离线使用。
项目档案应用项目
OpenMAIC 开源多智能体互动课堂平台 - 一键生成 AI 驱动课程，支持 PPT/HTML 导出
THU-MAIC/OpenMAIC：OpenMAIC 是一个开源多智能体互动课堂平台，通过 AI 自动生成结构化课程与实时交互环境，让用户仅需描述主题或上传材料，即可获得由 AI 本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
OpenMAIC 是一个开源多智能体互动课堂平台，通过 AI 自动生成结构化课程与实时交互环境，让用户仅需描述主题或上传材料，即可获得由 AI 教师和同学驱动的沉浸式学习体验，显著降低教学资源开发门槛。
中文项目介绍
OpenMAIC（Open Multi-Agent Interactive Classroom）是一个基于 Next.js 和 LangGraph 构建的开源 AI 教育平台。其核心用途是将任何主题或文档转化为丰富的互动课堂体验，用户只需描述学习主题或上传 PDF 等材料，系统即可自动生成包含幻灯片、测验、互动模拟和项目式学习活动的完整课程。
该项目解决了传统在线教育中内容制作耗时、互动性不足的痛点。通过多智能体编排技术，AI 教师和 AI 同学能够实时授课、讨论、在白板上绘图写字，并提供语音讲解，创造出高度沉浸的学习环境。这显著降低了高质量教学资源的开发门槛，使教育者能快速创建专业课程，学习者也能获得个性化、交互式的学习体验。
适用场景广泛：K12 及高等教育中的互动课程快速生成、企业培训与员工技能提升、自主学习与知识点复习，以及通过 OpenClaw 集成在飞书、Slack、Telegram 等协作平台即时创建学习场景。
技术特征方面，项目采用 Next.js App Router 架构，结合 React 19 和 TypeScript；使用 LangGraph 实现多智能体状态机协调；集成多种 LLM 提供商（OpenAI、Anthropic、Google 等）通过环境变量配置；支持 TTS/ASR 语音服务、PDF 解析、图像/视频生成；基于 Tailwind CSS 和 Radix UI 构建现代化界面；支持将课堂导出为可编辑的 PPTX 或交互式 HTML 页面。
详细信息与使用说明
2. 解决的问题
OpenMAIC 主要解决传统在线教育中内容开发效率低下和互动性不足两大问题。传统课程制作需要大量人工时间进行 PPT 设计、习题编写和互动环节设计，而 OpenMAIC 通过多智能体 AI 系统在几分钟内自动完成这些工作，大幅降低制作成本。同时，传统在线课程往往缺乏实时互动，而 OpenMAIC 的 AI 教师和同学能够动态响应用户输入，进行对话式教学、白板协作和语音交流，显著提升学习参与度和知识吸收效果。此外，平台还解决了教学资源格式单一的问题，支持多种导出格式满足不同分发需求。
3. 适用场景
OpenMAIC 适用于多种教育与培训场景。在 K12 及高等教育领域，教师可快速生成互动课程用于课堂教学或学生预习复习；在企业培训中，HR 部门能高效创建员工技能培训材料；对于自主学习用户，可通过输入感兴趣的主题获得个性化学习路径。此外，通过内置的 OpenClaw 集成，用户可以直接在飞书、Slack、Telegram 等日常使用的协作工具中，通过对话式 AI 助手即时创建和分享互动课堂，特别适合分布式团队的知识分享和远程学习场景。平台也适合教育技术开发者作为多智能体应用的研究参考实现。
4. 安装方式
根据仓库信息，OpenMAIC 的安装方式如下：首先确保系统已安装 Node.js 20.9.0 或更高版本；使用 pnpm 包管理器克隆仓库后执行 `pnpm install` 安装依赖，安装过程中会自动构建内置的 mathml2omml 和 pptxgenjs 本地包；复制 `.env.example` 文件为 `.env.local` 并配置至少一个 LLM 提供商的 API 密钥（如 OPENAI_API_KEY、ANTHROPIC_API_KEY 等），其他服务如 TTS、PDF 解析等可按需配置；开发模式下运行 `pnpm dev` 启动本地服务器，生产环境可运行 `pnpm build` 构建后 `pnpm start` 启动，或通过 Vercel 一键部署。注意项目依赖 pnpm 的 workspace 特性，建议使用 pnpm 而非 npm 或 yarn。
5. 使用方式
使用 OpenMAIC 的基本流程为：启动应用后访问首页，在输入框中描述想要学习的主题或直接上传 PDF 等学习材料；通过设置对话框选择偏好的 LLM 提供商、模型和语音等选项；点击生成按钮后，系统后台将调用多智能体编排引擎自动创建课堂内容，包括幻灯片大纲、测验题目、互动模拟等；生成完成后自动进入课堂界面，此时用户可与 AI 教师和 AI 同学进行实时互动，包括文字对话、语音交流、白板绘图等；在课堂过程中或结束后，可通过导出功能将内容保存为可编辑的 .pptx 文件或交互式 .html 页面。此外，通过 OpenClaw 集成，用户也可以在支持的聊天应用中直接向 AI 助手发送指令生成课堂。
6. 实现特点
OpenMAIC 在实现上具有多个技术特点。架构上采用 Next.js App Router，结合服务端组件与客户端交互，利用 LangGraph 构建多智能体状态机来协调 AI 教师与同学的行为。模块化设计方面，项目依赖本地包 mathml2omml 处理数学公式转换，pptxgenjs 处理 PPT 生成，并通过环境变量实现多提供商 LLM 的灵活切换。状态管理使用 Zustand，UI 组件基于 Radix UI 和 shadcn 构建，确保可访问性和一致性。平台支持流式响应和实时交互，白板系统基于 @napi-rs/canvas 实现高性能绘图。此外，项目包含完整的测试体系（Vitest 单元测试、Playwright E2E 测试）和国际化支持（i18next），代码质量与可维护性较高。
思维导图
OpenMAIC
核心架构
Next.js App Router
LangGraph 多智能体
环境变量配置
主要功能
一键课程生成
AI 教师与同学
白板绘图与 TTS
幻灯片/测验/模拟
PPTX/HTML 导出
集成能力
OpenClaw 消息平台
多 LLM 提供商
PDF 解析
图像/视频生成
技术栈
React 19 + TypeScript
Tailwind CSS + Radix UI
Zustand 状态管理
AI SDK + LangChain
常见问题
如何安装和运行 OpenMAIC？
确保 Node.js 20.9.0+ 和 pnpm 已安装，克隆仓库后运行 pnpm install 安装依赖（会自动构建内置包），复制 .env.example 为 .env.local 并配置至少一个 LLM API 密钥，然后运行 pnpm dev 启动开发服务器。也可通过 Vercel 一键部署。
需要配置哪些环境变量？
至少需要配置一个 LLM 提供商的 API 密钥，如 OPENAI_API_KEY 或 ANTHROPIC_API_KEY。此外还可按需配置 TTS 语音服务、ASR 语音识别、PDF 解析、图像生成、视频生成等服务的相关密钥和端点，具体参考 .env.example 文件。
OpenMAIC 支持哪些 LLM 提供商？
根据依赖项，项目支持 OpenAI、Anthropic、Google 等主流 LLM 提供商，通过环境变量配置即可切换使用。具体支持的模型列表可在应用设置界面查看。
如何导出生成的课堂内容？
在课堂界面中，用户可以通过导出功能将当前课堂内容保存为两种格式：可编辑的 .pptx 幻灯片文件，适合在 PowerPoint 中进一步编辑；或交互式 .html 页面，可在浏览器中直接运行并保留所有互动功能。
OpenClaw 集成如何使用？
OpenMAIC 内置 OpenClaw 集成，支持从飞书、Slack、Telegram 等 20+ 消息应用生成课堂。用户可以在这些平台的 AI 助手中发送指令（如“生成一个关于 Python 基础的课堂”），助手将调用 OpenMAIC 服务创建课堂并返回链接或预览。具体配置需在 OpenClaw 平台绑定 OpenMAIC 实例。