大家好，我是邵奈一，一个爱折腾的程序猿、斜杠青年。 文章对你有帮助是我的荣幸，欢迎评论区交流。

0x00 概述：文档到课堂，中间差的是什么

把一份 PDF 讲义、一段产品手册，变成一堂“能讲课、会板书、会提问、会讨论”的课——这件事过去只有两条路：要么人熬夜在 PPT 里手搓，要么丢给通用聊天机器人，得到的却是一堆答非所问的碎片回答。

清华 THU-MAIC 团队开源的 OpenMAIC（Open Multi-Agent Interactive Classroom，开放式多智能体互动课堂）把“文档 → 课堂”做成了可复用的自动化流水线：输入一个主题或一份文档，几分钟内产出包含幻灯片、测验、交互模拟、项目制学习（PBL）的完整课堂，并由一群 AI 老师与 AI 同学驱动互动。

本文基于一次真实的版本升级（从 v0.1.0 到 v1.0.0）展开，并补齐从零开始的安装路径，分三部分讲清：它是什么、怎么装（从零全新安装，或从旧版升级到 v1.0.0）、以及为什么它对"教育平权、企业培训、二次开发"三类场景都有价值。

0x01 OpenMAIC 是什么

出身与定位

协议改为 MIT 后，企业法务不再拦：嵌进内部培训系统、做成商业产品，都不需要公开改动。

和普通“AI 做 PPT”的本质区别

一句话：聊天 AI 是“私教答疑”，通用 PPT 工具是“帮你画幻灯片”，而 OpenMAIC 是“整堂 AI 课”。它把零散的对话，组织成了完整的教学体验。

0x02 核心特点：它凭什么能“讲课”

OpenMAIC 的生成管线分两阶段：先由 AI 规划课程大纲（Outline），再把大纲每一项展开为具体“场景”（Scenes）。场景由四大基础组件加一套多智能体互动机制构成。

四大基础组件

幻灯片（Slides）

AI 老师用自然语言语音旁白授课，配合“聚光灯”“激光笔”动效，像真老师一样指着内容讲解。

测验（Quiz）

学完即考，支持单选 / 多选 / 简答，AI 实时判分并讲清“为什么错”，而非只给对错。

交互模拟（Interactive Simulation）

浏览器里可动手操作的模拟器——物理实验、流程图、算法可视化，拖动滑块即可看结果变化。

项目制学习（PBL）

分配角色、安排里程碑、陪你做真实项目，学完一轮不是“知道”了，而是“做过”了。

多智能体互动课堂

这是 OpenMAIC 区别于所有“AI 课件生成器”的核心：

• AI 老师
  讲课、板书、答疑、带节奏。
• AI 同学
  提问、讨论、辩论，与你一起做项目。
• 协作白板
  智能体实时画方程、画流程图、写公式。
• 语音合成（TTS）
  多种语音引擎、可定制声音，部分支持声音克隆。
• 互动模式
  课堂讨论、圆桌辩论、自由问答（Q&A）、白板推导。

底层由 LangGraph 驱动的多智能体状态机编排，动作引擎支持 28 种以上动作类型（语音、白板、特效等）。

深度交互模式

v1.0.0 把“看课”变成“玩课”：3D 可视化、模拟实验、知识小游戏、思维导图、在线编程。学习者不是被告知规律，而是亲手“发现”规律。

导出与集成

• 导出
  可编辑 PowerPoint（.pptx，含图片 / 图表 / LaTeX 公式）、自包含互动 HTML、完整课程包 ZIP。
• 模型中立（Provider-Neutral）
  支持 OpenAI、Azure、Anthropic、AWS Bedrock、Google Gemini、DeepSeek、Qwen、Kimi、MiniMax、智谱 GLM、豆包、腾讯混元、小米 MiMo、Grok、OpenRouter，以及任何 OpenAI 兼容端点。
• 本地模型
  可接 Ollama（本地 LLM）、Lemonade（本地 LLM / 图像 / 语音）、FunASR（本地语音识别），零 API Key 也能跑。
• OpenClaw 集成
  通过 clawhub install openmaic，直接在飞书、Slack、Discord、Telegram 等 20 余款聊天应用里生成课堂，无需开终端。

v1.0.0 新增的 Agent 工作台

这是本次升级最值得关注的部分。打开 localhost:3000 后看到的便是入口首页（见下图），从这里开始与 Agent 对话建课：

• 对话式建课
  和 Agent 聊需求，它规划大纲、逐页生成、随时修改。
• 持久会话（Durable Sessions）
  服务端保存进度，浏览器刷新、进程重启都不丢，可暂停 / 恢复 / 改方向。
• 会话素材
  上传文档、音频、视频，或联网检索，Agent 基于它们建课。
• 20 余款内置技能
  幻灯片、测验、交互、PBL、图像、视频、语音、.pptx 导入。

0x03 怎么装：全新安装与升级到 v1.0.0

下面分两条路径：一条是作者一次真实升级的复盘（已装过旧版看这里），另一条是从零开始的全新安装（没装过看这里）。两条路径共用上方"前提条件"，都可能遇到下方"两处环境相关的注意点"。

前提条件

从零开始：全新安装

如果你之前没装过 OpenMAIC，走下面这条线，和"升级"是两条独立的路径：

# 1) 克隆仓库（建议浅克隆，避开全量历史卡顿）：git clone --depth 1 https://github.com/THU-MAIC/OpenMAIC.gitcd OpenMAIC# 2) 安装依赖（受限网络 / 管控 Node 环境见下文"两处环境相关的注意点"）：pnpm install# 3) 配置至少一个模型 Key：cp .env.example .env.local# 编辑 .env.local，填入 OPENAI_API_KEY / ANTHROPIC_API_KEY / GOOGLE_API_KEY 等# 4) 启动：pnpm dev# 打开 http://localhost:3000

装完打开 localhost:3000，看到的就是 v1.0.0 首页（见 0x02-E 配图），后续建课流程与 0x02-E 一致。

依赖要求（Node.js / pnpm / LLM Key）已在上方"前提条件"列出。如果 pnpm install 阶段遇到网络或符号链接报错，直接跳到下方"两处环境相关的注意点"对症处理。

升级前的真实状态

我本地的一份 OpenMAIC 安装，升级前处于如下状态：

版本：0.1.0最近提交：2026-03-20（fix(tts): ...）许可证：AGPL-3.0node_modules：缺失（当初装完没跑起来就搁置了）

从 v0.1.0（3 月）跨到 v1.0.0（8 月），中间隔了多个大版本，早期版本成熟度不够，这也解释了当初“课件样式错乱”的体验。

升级步骤（可复用）

# 1) 先打一个安全锚点，便于回滚：cd 你的 OpenMAIC 仓库目录git tag pre-upgrade-20260831# 回滚命令：git reset --hard pre-upgrade-20260831# 2) 拉取最新（浅拉 main，避开全量历史卡顿）：git fetch --depth 1 origin maingit reset --hard origin/main# 3) 安装依赖（注意点见下文）：pnpm install# 4) 配置至少一个模型 Key：cp .env.example .env.local# 编辑 .env.local，填入 OPENAI_API_KEY / ANTHROPIC_API_KEY / GOOGLE_API_KEY 等# 5) 启动：pnpm dev# 打开 http://localhost:3000

升级后的真实结果（终端输出节选）：

版本：1.0.0最新提交：9d16e68 fix(workbench): persist Pro conversation titles (#1273)  (2026-08-31)许可证：MIT License

启动后访问 http://localhost:3000，看到的就是 v1.0.0 首页（见 0x02-E 配图）。

两处环境相关的注意点

注意点一：pnpm 的 packageManager 字段触发“自管理”被拦截

项目 package.json 写了 packageManager: pnpm@x.y.z，pnpm 会尝试自下载这个精确版本，在部分受限网络环境下会被代理拦截。

解法：关闭 pnpm 的自管理版本行为即可，不需要改动项目文件：

npm_config_manage_package_manager_versions=false pnpm install

注意点二：部分管控环境拦截符号链接，pnpm 依赖 symlink 直接中断

pnpm 重度依赖符号链接（store 注册、node_modules 链接），而某些受管控的 Node 运行环境会拒绝创建符号链接，导致安装崩溃。

解法：换用不带该限制的 Node 运行环境执行 pnpm 入口脚本。例如用托管版 Node 直接运行 pnpm 的 pnpm.cjs：

NODE=/path/to/node20-or-22/bin/nodePNPM_JS=/path/to/pnpm/bin/pnpm.cjsNODE_OPTIONS= npm_config_manage_package_manager_versions=false \  PNPM_JS install --registry=https://registry.npmmirror.com

国内环境建议加上 --registry=https://registry.npmmirror.com 加速。

这两处都和 pnpm install 本身有关，无论全新安装还是升级，只要在受限网络或管控 Node 环境里跑安装都可能遇到；写在这里，是给两条路径都省下排查时间。

不想碰命令行？三条捷径

• 在线体验
  直接打开 open.maic.chat，每天可免费用几次，零安装。
• Docker 一行
  cp .env.example .env.local 填好 Key 后，docker compose up --build。
• Vercel 一键
  README 里的 Deploy 按钮，Fork 后填环境变量即可。

0x04 任何人用了，能得到什么

这一节是给“还没决定要不要装”的人看的。无论你属于哪类角色，OpenMAIC 都能给出对应的价值。

七类人群，各自的好处

最被低估的一点：可二次开发

很多人把 OpenMAIC 当成“生成课件的工具”，但它的真正价值是 可被集成：版本化的课程 DSL + @openmaic/* SDK 能把渲染器嵌进自己的 React 应用、把 .pptx 导入进 DSL、从内容管线吐出课程包；模型中立，接已有 Key 或本地模型都行。

它不是“用完即走”的 SaaS，而是可改造的平台。已有不少团队基于它做了二开产品。

0x05 适合谁，以及几个客观边界

适合：

• 想快速做互动课件 / 培训材料的老师、培训师、课程设计师；
• 需要把文档 / 论文 / 手册变成“能学”的产品的开发者、内容团队；
• 想研究“多智能体编排”参考实现的 AI 工程师；
• 想用本地模型、注重隐私和成本的个人。

几个客观边界（不是缺点，是范围）：

• 应用本身 MIT 免费，但每生成一堂课都会消耗 LLM token，重度使用要关注用量；
• MP4 视频导出需要额外的 Chromium + FFmpeg 渲染容器（docker compose --profile video-export up --build），不是基础安装就带；
• 开发模式的默认 token 不是真正密钥，只适合本机或可信网络，公网多用户部署前必须换成真实鉴权。

0xFF 总结与资源

从 v0.1.0 升级到 v1.0.0，OpenMAIC 已经从一个早期样式错乱的原型，变成一个完整的多智能体互动课堂平台：Agent 驱动建课、持久会话、可编辑导出、MIT 协议兜底的企业二开空间。

一句话：如果你希望“任何主题都能变成一堂会讲课、会板书的 AI 课”，它值得装一次，更值得改一次。

资源入口：

• GitHub：github.com/THU-MAIC/OpenMAIC
• 官网：openmaic.io
• 在线体验：open.maic.chat
• OpenClaw 技能：clawhub install openmaic

邵奈一 三百篇原创沉淀，十万+读者同行。感谢你的阅读，咱们下篇接着聊。