GitHub Trending 榜首:THU-MAIC/OpenMAIC — 一键开启多智能体沉浸式课堂

OpenMAIC(Open Multi-Agent Interactive Classroom)是清华 MAIC 团队开源的多智能体交互式课堂平台,把任意主题或文档一键转化为带 AI 老师、同学、幻灯片、测验、可交互仿真与项目式学习的沉浸式课堂,支持 16+ 大模型与本地推理,并深度集成 OpenClaw。

今日榜单冠军:THU-MAIC/OpenMAIC

Stars Forks Language License: MIT Next.js 16


项目定位:从 MOOC 到 MAIC,把课堂交给一群 AI

OpenMAIC(Open Multi-Agent Interactive Classroom)由清华大学 MAIC 团队开源,目标很直白——把任何主题、任何文档一键变成一堂"AI 老师 + AI 同学 + 实时讨论 + 多模态课件"的沉浸式课堂。与传统 MOOC 的"录像播一遍"不同,它用多智能体编排驱动整套教学流程:

  • 多智能体主持:AI 老师讲解、提问、点名;多个 AI 同学发起讨论、提出反例;用户随时插话
  • 多模态课件:语音讲解 + 激光笔 + 焦点高亮 + 白板手写(公式、流程图、思维导图)同步呈现
  • 沉浸式交互:3D 可视化、仿真实验、知识小游戏、思维导图、浏览器内编程,五种可交互 UI 自由组合
  • 结构化项目式学习(PBL):学生选择角色,与 AI 代理围绕里程碑与交付物协作完成项目
  • 跨设备运行:生成的 .maic.zip / .html 课件自带离线资源,可在内网/隔离环境播放

v1.0.0 在原有"一键生成"基础上新增了 Pro Workbench——把课程构建过程本身交由一个对话式代理完成:上传材料 → 制定大纲 → 自动构建并修订每一页 → 中途可暂停、可追加指令、可回放事件历史。

技术架构一览

层 关键技术栈
前端框架 Next.js 16(App Router)+ React 19 + TypeScript 5
样式系统 Tailwind CSS 4
多智能体编排 LangGraph 1.1 状态机驱动的 director graph
课程 DSL 自研 @openmaic/dsl + @openmaic/renderer + @openmaic/editor
持久化层 @openmaic/storage:浏览器 / HTTP / PostgreSQL / S3 多后端
课件生成 @openmaic/generation:Outline → Scenes 两阶段管线
动作引擎 28+ 动作类型(speech / whiteboard / spotlight / laser …)
接入生态 OpenClaw Skill 已在 ClawHub 上架,可从 Feishu / Slack / Discord / Telegram 一键调用

支持的模型与推理后端覆盖度高,亮眼的几个:

  • 公有云:OpenAI(含 GPT-5.5 / GPT-5.6 / GPT-Image-2)、Azure OpenAI、Anthropic(Opus 4.8 / Sonnet 5)、Amazon Bedrock、Google Gemini(推荐 Gemini 3 Flash)、DeepSeek(V4)、Qwen、Kimi、Grok、OpenRouter、豆包、腾讯混元 / TokenHub、小米 MiMo、智谱 GLM
  • 本地推理:Ollama、Lemonade(LLM + TTS + ASR + 图像四合一本地服务)、VoxCPM2(OpenBMB 开源 TTS + 声音克隆,含 vLLM-Omni / Python API / Nano-vLLM 三种后端)、FunASR(本地语音识别)
  • 文档解析:MinerU、AliDocMind、ffmpeg + ffprobe 本地音视频抽帧
  • 可选 Render Service:基于 Hyperframes 在隔离容器内一键导出 MP4

v1.0.0 的关键能力增量

  1. Pro Workbench(代理工作台)
    • 聊天驱动的课程构建工作区:计划 → 构建 → 修订 → 发布
    • 持久化 session:服务端持有运行 lease,可在 worker 重启后恢复;中途可取消、追加指令、回看事件流
    • 内置 20 个技能:课程规划 / 深度研究 / 交互 / 讲义 / 工作坊 / 职业课程 / 幻灯片工艺 / PPTX 导入 / 编辑 / 风格复用
  2. 课程构建能力
    • Stage DSL 原子化 patch;支持生成、复制、插入、删除、重排页面
    • 课件可同时上传文档、音频、视频,或从 Web 搜索拉取材料
    • 用户自定义技能按 owner 维度存储,复用同一套 runtime
  3. Provider-Neutral 服务端
    • 凭据不下发到浏览器;<CAP>_<PREFIX>_ENABLED=false 显式开关可强制关闭任何服务端能力
    • 模型未路由到可用 provider 时直接 fail-loud,绝不"猜一个厂商"
    • PostgreSQL 后端可选:内置 server-persistence profile 一键启动,可选启用 Agent Runtime

一键跑起来

1
2
3
4
5
git clone https://github.com/THU-MAIC/OpenMAIC.git
cd OpenMAIC
pnpm install
cp .env.example .env.local        # 至少填一个 LLM API Key
pnpm dev                          # 浏览器打开 http://localhost:3000

需要服务端持久化 + Pro Workbench:

1
2
3
4
5
6
printf '\nDATABASE_URL=postgres://openmaic:openmaic-dev@postgres:5432/openmaic\nPERSISTENCE_DEV_TOKEN=openmaic-local-dev\n' >> .env.local
NEXT_PUBLIC_PRO_WORKBENCH_ENABLED=true \
OPENMAIC_AGENT_RUNTIME_ENABLED=true \
DATABASE_URL=postgres://openmaic:openmaic-dev@postgres:5432/openmaic \
MODEL_ROUTES='{"maic-agent-driver":{"model":"openai:gpt-5.5","api":"openai-completions"}}' \
docker compose --profile server-persistence up --build

⚠️ 安全提示:仓库 README 明确强调 PERSISTENCE_DEV_TOKEN / NEXT_PUBLIC_PERSISTENCE_TOKEN 会被编译到前端 bundle,不提供任何访问隔离——它只是一个"挡住无关网络扫描器"的占位符;上线前必须按 lib/persistence/server-auth.ts 接入真实的会话/身份校验。

OpenClaw 集成亮点

OpenMAIC 已经官方上架 ClawHub,一条命令即可把"AI 课堂生成"接入到飞书 / Slack / Discord / Telegram / WhatsApp 等 20+ IM:

1
clawhub install openmaic

随后对 Claw 一句"教我量子物理",它就会拉起代理、构建课件、把生成的链接推回聊天窗口。OpenMAIC 同时提供 Hosted 模式(在 open.maic.chat 拿 access code,无需本地部署)与 Self-hosted 模式(本地 clone → 配置 → 启动,全程有确认式 SOP)。

值得关注的延伸

  • 生态联动:和 OpenClaw 跨 IM 通道交付,与 claudex / archify 等"Agent Skill"思路契合,可作为"生成式教育"基础设施
  • 可拆装能力:@openmaic/* npm SDK 家族(dsl / renderer / editor / importer / generation / storage)已发布,可独立嵌入到其他 Next.js 项目
  • i18n:界面支持 12 种语言(含简繁中文、英、日、韩、俄、阿、巴西葡、墨西法、越、德)
  • 离线/内网:导出的 .maic.zip / 资源包已经把 KaTeX、Three.js、Tailwind CDN、Google Fonts 等外部静态资源 inline 到 data URI,真正可在断网机房播放

适用场景

  • 一线教师 / 培训师:3 分钟把讲义大纲变成可点开的互动课件
  • 企业内训:把会议纪要 / 产品手册转成可讲解的"AI 讲解版"
  • 自学者:把 PDF / 论文 / 视频课转成可互动的"AI 陪练课堂"
  • 二次开发:以 @openmaic/* SDK 为底座,在自有 Next.js 应用中嵌入"AI 老师能力"

一句话总结

MAIC = Multi-Agent Interactive Classroom:把"老师 + 学生 + 课件 + 作业"装进同一个智能体网络,用 LangGraph 编排、Next.js 呈现、PostgreSQL 持久化、OpenClaw 触达——OpenMAIC 是当前最接近"AI 替你上一堂课"形态的开源实现。

如果你是做 AI Agent / 教育 SaaS / 多模态课件的工程团队,这一份本周登顶 Trending 的清华出品,值得现在就去 star + 跑一次 demo。


参考链接

  1. THU-MAIC/OpenMAIC 仓库
  2. 在线 Demo(Hosted Mode)
  3. JCST'26 论文:From MOOC to MAIC
  4. OpenClaw 集成说明
  5. v1.0.0 Release Notes
  6. CHANGELOG(详细版本日志)
  7. LangGraph 多代理编排介绍
  8. OpenBMB VoxCPM2 TTS(含声音克隆)