OpenMAIC（Open Multi-Agent Interactive Classroom）是由清华大学（THU-MAIC）研究团队推出的开源多智能体互动课堂平台。它基于前沿的大语言模型（LLM）与多智能体编排架构开发，能够将任何用户输入的知识主题或上传的文档资料，一键自动转化为结构化、可视化的交互式数字课堂。在OpenMAIC生成的课堂中，由AI扮演的教师和同学会接管教学流程，它们不仅能通过语音朗读课件，还能在共享白板上实时手绘图表、书写数学公式，并与人类学习者进行实时的问答和圆桌辩论。
为打破传统在线教育被动听讲的局限，OpenMAIC特别引入了“深度交互模式（Deep Interactive Mode）”。该模式支持直接在浏览器中渲染3D立体可视化模型、提供动态调整参数的物理过程仿真模拟、内置代码编辑器供在线编程验证，并自动生成关联知识框架的思维导图。此外，该平台支持无缝对接OpenClaw智能插件，用户可直接在飞书、Slack、Telegram等日常聊天软件中命令AI助手生成教学链接。平台提供极致的数据灵活性，无论是对接国际主流AI模型，还是进行完全离线的本地模型部署，OpenMAIC都能高效满足碎片化自学、专业论文研读和企业培训等多样化场景的教学需求。
功能列表
- 一键生成结构化课程：输入学习主题或上传参考文档（支持PDF），后台算法自动进行两阶段处理，在数分钟内生成完整的课程大纲、图文幻灯片及课后测验内容。
- 多智能体课堂交互体系：内置不同设定的AI老师与AI同学。支持自动讲解、发起多角色圆桌辩论、实时课堂提问解答以及自由探索等拟真交互场景。
- 深度交互场景渲染模式：
- 3D可视化展示：针对抽象结构自动渲染三维视角模型，支持鼠标拖拽全方位观察。
- 动态仿真模拟：自动生成带物理机制或流程机制的实验环境，可调节参数观察实时变化。
- 互动式学习游戏：内置小型知识巩固关卡，在交互挑战中加深记忆点。
- 在线编程实验室：在网页端提供直接编写、修改并即时运行代码的编译环境。
- 自动思维导图：根据知识逻辑即时生成可缩放的系统知识结构图。
- 智能动态白板与语音合成：AI能够通过内置TTS技术用人声讲解知识，并能在白板上使用指示器高亮重点、逐步手绘流程图及演算复杂公式。
- 多格式资产导出：支持将生成的完整课程一键导出为保留排版与格式的可二次编辑PowerPoint（.pptx）文件、包含交互的单页离线HTML或课堂数据ZIP包。
- 高度兼容的开放LLM接入：支持OpenAI、Google Gemini、Anthropic、DeepSeek、智谱GLM、MiniMax等国内外主流API，并支持通过Ollama连接本地私有模型。
- 聊天软件捷径集成（OpenClaw）：无缝打通即时通讯工具，可在飞书、Slack、Discord中通过发送聊天指令让机器人后台自动排队生成课堂链接。
使用帮助
OpenMAIC 提供了极高的灵活性，无论您是期望快速体验生成能力的用户，还是需要进行私有化数据隔离部署的开发者，都可以找到对应的使用路径。以下为您呈现全方位的安装配置与核心功能操作指南，请按照步骤操作，开启您的智能互动学习之旅。
🌟 一、 快速安装与本地化部署指南
为了获取无延迟、最完整的深度交互能力，强烈建议具备一定开发基础的用户使用本地环境进行部署。
1. 基础环境准备
在克隆项目之前，请确保您的操作系统环境中已正确安装并配置以下基础软件：
- Node.js：版本要求必须
>= 20.9.0，为后端和前端组件提供运行支持。 - pnpm：强大的前端包管理工具，版本要求
>= 10。
2. 获取源码与依赖安装
打开您的终端（Terminal / PowerShell / iTerm2），依次执行以下命令，将官方项目源码克隆到本地，并自动化安装所需的所有依赖环境包：
git clone https://github.com/THU-MAIC/OpenMAIC.git
cd OpenMAIC
pnpm install
3. 配置环境变量与大语言模型 (LLM)
多智能体互动的核心依赖于大语言模型强大的逻辑能力。OpenMAIC 支持丰富的模型接口对接。
首先，在根目录复制生成环境变量文件：
cp .env.example .env.local
使用文本编辑器打开 .env.local 文件，填入您所使用的大模型 API 密钥。
常用大模型配置示例：
- OpenAI：
OPENAI_API_KEY=sk-... - 智谱 GLM：
GLM_API_KEY=您的密钥并在下方配置GLM_BASE_URL=https://open.bigmodel.cn/api/paas/v4 - 本地断网模型：如果您有极高的数据隐私需求，也可在环境文件中绑定本地运行的 Ollama 服务端口地址。
💡 最佳体验建议：为获得内容生成质量与推理速度上的最佳平衡，推荐使用 Google Gemini 3 Flash。如需设置该模型为全局默认，可在配置文件中添加 DEFAULT_MODEL=google:gemini-3-flash-preview。
4. 启动平台服务
在终端运行开发环境启动命令：
pnpm dev
此时系统将在后台启动本地服务器。打开现代浏览器（推荐 Chrome 或 Edge），访问地址 http://localhost:3000，即可看到 OpenMAIC 的工作主界面。
📌 其他部署方式补充：
- Docker 一键部署：修改好
.env.local密钥后，终端执行docker compose up --build即可实现环境隔离的容器化稳定运行。 - 设置访问加密保护：若您部署在公网访问环境，可在
.env.local加入ACCESS_CODE=您的专属安全密码。这样所有外部访问者都会被拦截要求验证，防止接口额度被盗刷。
🎓 二、 零基础快速生成并体验互动课堂
配置并成功进入 Web 界面后，您将看到极简的课程工作台。请按照以下三个标准流程操作：
第一步：输入核心主题或上传知识文档
在主页的大面积文本输入区域中，明确输入你想学习的内容。例如：“请向我解释宏观经济学中的供需原理”或“如何使用 Python 开发一个爬虫脚本”。
如果您有专门的教材、专业论文，可以通过点击左下角的“附件”按钮上传 PDF 文档，系统将使用内置算法识别提取文档内的文本、表格与复杂数学公式。
第二步：审核并微调生成的课程大纲
点击“生成（Generate）”按钮，AI 会在几秒钟内输出一份结构化课程大纲（Outline）。
大纲以树状节点展现，在这里你可以直接像编辑目录一样去操作：
- 点击“+”号添加新的知识扩展小节。
- 点击垃圾桶图标删除不需要讨论的话题。
- 双击节点修改具体章节内容的探讨方向。
第三步：内容渲染与进入课堂
确认大纲后，系统自动进入场景渲染（Scenes）阶段。多智能体会并行工作，分别生成语音朗读脚本、幻灯片排版配图以及测验题。
等待进度条跑满，点击界面的“开始上课”。此时你将进入一个拟真的数字虚拟教室。
- 沉浸式听讲：画面主视觉播放幻灯片并带有激光笔的高亮动画指示，AI教师会自动采用 TTS 技术用人声逐页为您讲解重点。
- 打断提问机制：听到生涩概念时，立刻在下方聊天框输入提问（或使用麦克风语音输入）。AI教师会暂停幻灯片进度，直接对您的提问展开通俗解答。若需要演示，它还会主动切出动态白板（Whiteboard），为您手写绘制数据流程图或推导复杂公式。
🎮 三、 深度交互模式（Deep Interactive Mode）探索
在面对需要动手实践的学科（如编程、物理或立体结构）时，OpenMAIC 会在对应章节自动调出深度交互 UI：
- 当学习物理过程时：会弹出仿真物理模拟器。你可以滑动页面中的数值拉杆（如改变重力加速度、温度），实时观察系统的实验动态反馈。
- 当学习计算机编程时：画面会自动分屏切出在线代码编辑器（Online Programming）。系统为您初始化了一段基础代码，您可以在网页上直接改写并点击“执行（Run）”查看终端输出结果，代码报错时 AI 还会实时指导如何修复。
- 当学习人体或分子结构时：通过3D 结构可视化控件，您可以用鼠标左键长按拖拽进行 360° 全方位观看剖面。
- 当进入章节复习总结时：触发**全局思维导图（Mind Map）**模式，清晰展现本节知识图谱网络，通过节点点击可回顾过往的教学内容。
📤 四、 一键分享与多格式课堂文件导出
一堂精彩的互动课程结束后，进行资产化沉淀和分享非常关键。点击页面右上角的 导出（Export） 按钮即可弹出导出选项：
- 导出为 PowerPoint (.pptx)：系统会将生成的每一页幻灯片转换为格式完全保留的原生 PPT。生成的图表元素、图片均不会转为死图，而课程内的公式会被精准转换为原生的 Office Math 公式格式，极为方便后期用于学校答辩或会议演讲的二次修改。
- 导出为 Interactive HTML：若您想将“仿真模拟、互动测验”等功能保留，可导出这个独立的 HTML 单页文件。它无需网络也能在本地浏览器中完美运行，是最理想的离线复习资料库。
- 导出为 Classroom ZIP：系统会打包包括课程数据结构、媒体语音素材在内的完整源码包，适合分享给朋友用于导入他们的 OpenMAIC 平台进行原貌重现。
按照上述帮助指引，您将能毫无障碍地掌握 OpenMAIC 的系统逻辑，全面释放多智能体教育带来的惊人效率！
应用场景
- 个人零基础自学与沉浸式探索
无论是学习一门新的编程语言，还是了解复杂的科学原理，用户只需输入学习目标，平台即可生成包含图文解析、代码演练环境和知识测验的结构化课程。AI老师会耐心语音讲解，通过内置编程环境辅助用户边学边练。 - 专业外文文献深度阅读与财报解析
科研工作者或金融分析师可直接上传数百页的英文长篇论文或财报PDF文档。多智能体系统能够快速提取核心数据逻辑，生成多视角的探讨课堂，并通过白板动态绘制图表演示数据关系，大幅降低复杂信息的理解门槛。 - 企业标准业务培训与互动式指导
企业管理人员可以将冗长枯燥的员工入职手册或软件操作SOP文档一键转化为互动的AI在线课堂。新员工能在培训过程中随时向AI导师提问，并通过平台内置的随堂测试验证学习成果，提升培训的趣味性和知识留存率。 - K-12理科直观科普与虚拟实验展示
教育工作者能利用此工具将抽象复杂的教材概念转化为生动立体的沉浸式实验课。利用深度交互模式中的“3D可视化”与“物理仿真模拟器”，学生可以在屏幕上亲手调整参数、观察结构变化，充分激发理科知识探索的兴趣。
QA
- OpenMAIC 支持哪些大语言模型（LLM）？
OpenMAIC 具有极强的接口兼容性，目前支持通过配置API Key的形式调用市面上绝大多数主流大模型，包括 OpenAI (GPT系列)、Anthropic (Claude)、Google Gemini、DeepSeek、智谱 GLM、MiniMax、Grok 以及字节跳动 Doubao 等。它同时支持接入Ollama等本地服务实现完全离线运行。 - 如果企业希望保护本地数据隐私，如何实现彻底不上云运行？
平台具备纯本地化运行能力。你可以先在本地设备通过 Ollama 部署开源的大语言模型（如Llama 3等），然后将 OpenMAIC 的主干代码进行本地或者局域网内部的 Docker 私有化部署。在此架构下，课程生成的全部流程解析（含文档分析提取）均在局域网内闭环完成，数据绝对不会发生外流。 - 通过平台导出的PPT文件是静态图片吗，可以后续修改吗？
导出的 PowerPoint（.pptx）文件是完全可二次编辑的高质量文档格式。OpenMAIC 的导出引擎能够保留原生的文本排版框、各类形状及插入的图片资源。不仅如此，系统内生成的数学计算和推导公式也能被转化成原生的 LaTeX 或 Office Math 格式，方便你在电脑本地软件中任意修改和增删。 - 如果我没有部署代码的技术基础，是否可以开箱即用？
完全可以。OpenMAIC 原生集成了 OpenClaw 工具。如果您不懂如何部署，可以采用云托管模式（Hosted Mode），只需在 open.maic.chat 平台获取一次性的访问验证码（Access Code），随后在飞书、Slack、Telegram 或 Discord 等常用聊天软件中对AI机器人发送一句自然语言指令，系统便会在云端排队生成课程，并直接给您返回可以打开在线上课的网页链接。 - 系统在课堂中生成的随堂测验题支持自动打分批改吗？
支持自动批改评估。当授课进行到测验环节时，AI 教师会自动在屏幕上呈现单选题、多选题或简答题。当您在线点击选项并提交答案后，多智能体会在后台对您的选择进行评估，不仅会实时打分，还会针对您选错的部分给出针对性、口语化的原理纠错解析。
