🔥 清华 OpenMAIC 保姆级教程｜0 代码也能搭 AI 课堂，小白到大神全攻略-熊猫会飞

前言

OpenMAIC是清华大学团队开源的L4级多智能体AI课堂系统，能一键生成AI老师+AI助教+AI同学的虚拟课堂，自动产出PPT、语音讲解、随堂测验与互动模拟。不管是家长辅导作业、老师备课、学生自学，还是开发者二次开发，都能快速上手。

一、核心优势

免安装免登录：网页打开即用，0门槛
免费开源：无基础费用，支持本地私有化部署
多角色互动：AI讲课+AI提问+AI陪学
一键导出：PPT/HTML离线保存
高度自定义：可改AI性格、音色、功能

二、四层使用指南（完整可操作）

🔹 第一层：小白必看 · 网页即用（5分钟上手）

适合：家长、学生、纯小白、不想装软件的人

打开官方体验地址 访问：https://openmaic.ai ✅ 免注册、免登录、免绑手机
输入学习需求 例：
- 五年级鸡兔同笼，用小孩能听懂的方式讲
- 零基础学Python，从零开始
- Transformer模型原理，通俗版
等待生成 常规内容：15–30分钟 小文件（＜10M）更快，大文件会更久
进入虚拟教室
- AI老师：语音+白板讲解
- AI助教：补充知识点
- AI同学：互动提问学完可导出PPT/HTML本地保存

🔹 第二层：进阶玩家 · 接入更强AI（速度翻倍）

适合：想要更快、更准、更流畅体验的用户

获取API Key 推荐：蓝耘 Lanyun（便宜、按量付费、兼容好）注册 → 进入API管理 → 复制API Key 模型：/maas/jieyue/step-3.5-flash
填入OpenMAIC配置
- API模式：OpenAI协议
- Base URL：https://maas-api.lanyun.net/v1
- API Key：粘贴你的Key
- Model Name：/maas/jieyue/step-3.5-flash
费用说明（修正原文错误） 一节课约 1–2美元，按2026年汇率≈ 7–14元人民币 比家教、网课成本低很多

🔹 第三层：高阶折腾 · 本地部署（完全私密免费）

适合：注重数据隐私、想无API费用、技术爱好者/机构

必备环境

Node.js（v20及以上）
Git
Docker Desktop（安装后重启电脑）

一键部署命令

git clone https://github.com/THU-MAIC/OpenMAIC.git
cd OpenMAIC
pnpm install
cp .env.example .env.local

用记事本打开.env.local，填入你的API Key

pnpm dev

打开浏览器访问：http://localhost:3000

⚠️ 重要修正

无官方免费测试Key，必须填自己的API Key
本地部署部分依赖需要科学上网
原文“45M PDF等15分钟没反应”修正：大文件生成时间会显著延长

本地专属玩法

捏AI性格
- 严厉清华教授、温柔幼教、幽默脱口秀
- AI同学可设“杠精版”“小白版”
换音色：支持多音色TTS
扩功能：图像生成、视频、联网搜索

🔹 第四层：开发者 · 二次开发深度定制

技术栈

前端：Next.js + React + TypeScript
智能体：LangGraph
部署：Docker Compose

可做什么

接入国内外大模型（OpenAI、Gemini、通义千问、GLM等）
新增角色：外教、考官、题库机器人
集成到飞书、Slack、Discord、微信
基于AGPL-3.0协议商用二次开发

三、避坑指南

1. 生成太慢

原因：云端算力有限，大文件耗时久
解决：文件控制在10M以内；接入第三方AI加速

2. 网页卡顿

解决：刷新页面；换Chrome浏览器；改用本地部署

3. 讲解错误/跑偏

解决：指令写具体；上传参考文档让AI按材料讲

4. API配置失败

检查Base URL必须以/v1结尾
API Key不要带空格
备选模型：Gemini 1.5-flash（官方推荐）

四、快速选择建议

纯小白：直接打开网页版，15分钟体验一节课
进阶用户：花10元左右接蓝耘模型，体验大幅提升
隐私党/机构：本地部署，完全私有、无云端泄露
开发者：GitHub拉源码，二次开发做产品

五、官方资源

官方体验地址：https://openmaic.ai
GitHub源码：https://github.com/THU-MAIC/OpenMAIC

文章版权归作者所有，未经允许请勿转载。

THE END

人工智能

🔥 清华 OpenMAIC 保姆级教程｜0 代码也能搭 AI 课堂，小白到大神全攻略

前言