初探 OpenMAIC：理想与现实的差距

最近在 GitHub 上发现一个名为 OpenMAIC（Open Multi-Agent Interactive Classroom）的项目，声称只需输入主题或上传资料，就能自动生成包含幻灯片、语音讲解、互动测验和模拟实验的完整课程。项目已收获超 7600 个 Star，热度不凡。

其核心理念是构建一个多智能体协作的学习环境：由 AI 教师授课、AI 同学参与讨论，支持白板绘图、公式推导、语音输出，并可嵌入飞书、Slack 等即时通讯工具中使用。

关键功能概览

• 自动化课程生成：输入主题或文档，自动拆解内容并组织为教学模块
• 多角色智能体：AI 教师与虚拟学生协同完成讲解与问答
• 多样化输出形式：支持幻灯片（PPTX）、交互网页（HTML）、测验题、项目式学习任务
• 实时交互能力：具备白板书写、数学公式绘制、语音播报等功能
• 跨平台集成：通过 OpenClaw 插件，在多种聊天应用中直接触发课堂创建

部署过程：从安装到启动

按照官方指引进行克隆与依赖安装：

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

后续需配置环境变量文件：

cp .env.example .env.local

修改其中的大模型接口地址，例如使用 GLM 服务：

ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/paas/v4

启动服务时遇到版本冲突提示：

ERR_PNPM_BAD_PM_VERSION This project is configured to use v10.28.0 of pnpm. Your current pnpm is v9.1.4

解决方法是升级 pnpm 版本：

npm install -g pnpm@10.28.0

再次执行 `pnpm dev` 后，本地服务正常运行，访问 http://localhost:3000 可见前端界面。

首次测试：为何无法生成课程？

尝试以"小龙虾"为主题，上传一份 8.1MB 的科普 PDF 文件，输入提示词："我对小龙虾不了解，希望了解它的种类、养殖方式以及食用方法。"点击进入课堂后，系统未能成功生成内容。

查看日志后发现关键信息：

[2026-03-19T13:05:33.989Z] [INFO] [ServerProviderConfig] Loaded (server-providers.yml): 1 LLM, 0 TTS, 0 ASR, 0 PDF, 0 Image, 0 Video, 0 WebSearch providers

这说明虽然已配置大语言模型（LLM），但其他核心服务均未启用，导致功能受限。

各服务组件的作用解析

字段	全称/含义	作用	状态说明
LLM	大型语言模型	负责内容生成、对话理解、智能体行为决策	✅ 已配置（1个）
TTS	文本转语音	将教师发言转为音频输出	❌ 未启用，无法播放语音
PDF	PDF 解析服务	提取上传文档中的文字内容	❌ 无法处理上传的 PDF
Image	图像处理服务	生成或渲染教学图表、流程图、公式图像	❌ 白板仅支持纯文本
Video	视频处理服务	生成或解析教学视频片段	❌ 不支持视频功能
WebSearch	网络搜索服务	获取实时外部知识，补充模型训练数据	❌ 无法联网查询新信息

由此可见，该项目并非"开箱即用"的全自动系统，而是需要开发者自行搭建完整的 AI 服务链路才能实现全部功能。

总结：技术愿景与落地成本

OpenMAIC 展现了极具前瞻性的教育智能化构想——将知识转化成可交互、可感知的教学体验。然而，实际部署所需的服务组件繁多，包括但不限于独立部署的 TTS 引擎、PDF 解析器、图像生成服务等，每项都需要额外资源投入。

对于普通用户而言，即便拥有强大算力，也面临配置复杂、调试困难的问题。若追求低成本试用，目前尚难实现真正意义上的"一键生成"。

该项目更适合有 AI 平台开发经验的团队，作为构建下一代智能教学系统的原型参考。