OpenMAIC：把一个主题变成能讲课、能动手的 AI 课堂

多数 AI 教学工具交付的是一叠材料：几页幻灯片、一段讲解视频、一份选择题。材料生成了，学习过程并没有发生。OpenMAIC（Open Multi-Agent Interactive Classroom）换了个目标——给一个主题或一份资料，生成一间可以讲解、提问、动手操作和讨论的课堂。项目由清华 THU-MAIC 团队开源，采用 MIT 许可，主要语言 TypeScript，截至 2026 年 10 月 19 日有 40,999 颗星。

核心功能

• 生成分两段：先把输入资料分析成结构化提纲，再按提纲逐场景生成内容。课程结构与页面内容分开产出，避免一边写内容一边排版。多智能体用 LangGraph 编排，老师、同学和课堂导演各管一件事：讲解、讨论、操作白板、出题、切场景。
• 五种可交互场景：3D 可视化、物理或流程模拟、知识小游戏、思维导图、浏览器内编程。学生在里面调参数、看结果变化，AI 老师会主动高亮关键区域、设置条件、给提示。
• Pro 工作台：v1.0.0 起提供一个对话式备课 Agent。它能规划多课时的课程表、原子化修改单个场景、上传并解析文档/音频/视频、生成图片视频与旁白，会话存在服务端，可以暂停、恢复、追加指令。内置 24 项技能，覆盖课程设计、深度研究、讲座、工作坊、PPTX 导入与样式复用。
• 导出三种形态：保留全部场景的 .pptx、能离线播放整节课的单个 .html、以及可搬到另一套部署的课程 ZIP。v1.2.0 起导出是正式功能，服务端优先的生成方式也稳定了——关掉标签页或重启服务，生成照常继续。
• 模型与存储都解耦：openmaic.yml 声明可用的模型供应商，再给每个用途（大纲、幻灯片、TTS、联网搜索）指定模型，支持 OpenAI、Anthropic、Gemini、DeepSeek、Qwen、Kimi、MiniMax、豆包、混元、智谱、Ollama、Lemonade 等，也支持任意 OpenAI 兼容接口。课程默认存 PostgreSQL，媒体可放 PostgreSQL 或 S3。

典型使用场景

• 老师备一节新课：把教材章节或论文丢进去，先拿到提纲，改完再让它生成幻灯片、随堂测验和一个能动手的实验，最后导出 PPTX 放回自己的课件体系。
• 自学一个陌生领域：不看视频，直接进课堂，让 AI 老师讲一段、自己操作模拟、答错题后追问。课堂里的旁白由 TTS 生成，需要自建语音服务时可以参考 VoxCPM 的本地方案。
• 培训机构批量出课：Pro 工作台的会话可恢复，适合把一个主题拆成多节课慢慢改；样式复用技能让同一套视觉规范套到不同课程上。
• 从聊天工具里直接开课：项目自带 OpenMAIC Skill，可接入 OpenClaw、Codex、DeepSeek、WorkBuddy 等工作台，从飞书、Slack、Telegram 或 IDE 里发起生成。

快速上手

要求 Node.js ≥ 22.19、pnpm ≥ 10，以及 PostgreSQL 16（pnpm db:up 会用 Docker 起一个开发库）：

git clone https://github.com/THU-MAIC/OpenMAIC.git
cd OpenMAIC
pnpm install
cp .env.example .env.local
cp openmaic.example.yml openmaic.yml
pnpm db:up
pnpm dev

在 .env.local 里至少填一个模型供应商的 Key，并按需取消 DATABASE_URL 那行的注释，然后打开 http://localhost:3000。没有 DATABASE_URL 时服务会拒绝启动并给出提示。生产环境用 pnpm build 加 pnpm start，并保证进程长期运行，因为生成在服务端进行。

小结

对想把知识变成可操作体验的人，OpenMAIC 是目前开源里完成度最高的一套：它不止生成内容，还把讲师、同学、白板、测验和交互实验编进了同一套运行时。40,999 颗星和从 v0.1 到 v1.2.1 的迭代节奏说明社区在用。

上手前要知道三件事。第一，它不是轻量工具：要 PostgreSQL，生成要在服务端长跑，Vercel 部署停留在 1.1.x，1.2 起需要自己托管。第二，权限边界要自己补：官方 README 明确说 ACCESS_CODE 不是账号体系，部分开发令牌没有用户隔离，多人使用前应接入真正的身份认证。第三，安全修复很密集：v1.0.1 到 v1.0.3 连续修了路径校验、存储型 HTML、SSRF、访问码过期与 Next.js 漏洞，v1.1.1、v1.1.2 又补了两处，自建实例应跟到最新版。它不会替老师判断目标、难度和事实是否准确，生成结果仍要人过一遍。MIT 许可，TypeScript。