扔掉枯燥的录播课！手把手教你用OpenMAIC搭一个“AI全天候陪读班”你有没有这种经历：兴致勃勃买了个网课，看了十分钟

你有没有这种经历：兴致勃勃买了个网课，看了十分钟就想刷手机，最后课程在收藏夹里吃灰？传统的在线教育（比如MOOC）最大的问题就是“一个人面对屏幕干瞪眼”，毫无参与感，所以辍学率一直居高不下。

最近清华大学开源了一个叫 OpenMAIC 的项目，我实际折腾了一把，发现它确实抓住了痛点。说白了，它能把一份干巴巴的PDF或Word文档，瞬间变成一个“热闹的虚拟教室”：里面有AI老师主讲，有AI助教辅导，还有几个AI同学在旁边跟你一起讨论、甚至抬杠。你不仅能看着它画白板、做测验，还能搞模拟实验。

这东西在清华真实学生里测了两年，满意度挺高。最吸引我的是三个点：完全开源免费、可以本地部署（数据不泄露）、成本低到离谱（一节课不到2美元）。

如果你也厌倦了被动听课，想体验一下“沉浸式”学习，咱们今天就把它在Windows上跑起来，并接上便宜好用的大模型。

第一章：在Windows上把环境跑通（小白向）

OpenMAIC是基于Next.js开发的，最省心的跑法是用Docker。如果你对命令行发怵，跟着下面的流程图和步骤走，10分钟就能搞定。

具体操作步骤：

备齐小工具

去官网下载安装 Node.js (v20以上) 和 Git。装好Node.js后，打开PowerShell（管理员模式），敲一行命令装上包管理器：

npm install -g pnpm

搞定Docker（最关键的一步）

去 Docker官网下载Windows版，一路默认安装，装完会要求重启电脑。

重启后，打开Docker Desktop，等右下角的小鲸鱼图标变绿，说明引擎启动成功了。

在PowerShell里敲这几个命令确认一下：

检查 Docker 版本
docker --version

检查 Docker Compose 版本
docker compose version

运行测试容器
docker run hello-world

如果都能输出版本信息，就说明准备好了。

一键启动项目

把你下载好的OpenMAIC压缩包解压到某个盘（比如 D:\xm\OpenMAIC-main）。

在PowerShell里进入这个文件夹：

cd D:\xm\OpenMAIC-main————切换到自己实际安装的目录

然后敲下这行魔法命令（加了 -d 是让它在后台安静地跑）：

docker compose up --build -d

第一次跑需要下载依赖，去泡杯咖啡等10分钟左右。看到没报错后，浏览器输入 http://localhost:3000，恭喜你，页面出来了！

第二章：接上“大脑”——蓝耘大模型接入指南

框架跑起来了，但里面还是个“傻白甜”，需要接上大模型（LLM）才能干活。这里我推荐接蓝耘（Lanyun）元生代MaaS平台的模型，原因很简单：它兼容OpenAI的接口格式，不用改代码，而且按量计费，用一点点算一点，非常划算。

怎么填配置？

拿钥匙：登录蓝耘平台，找到API管理页面，把你的 API Key 复制下来。我们这次用的模型是 /maas/jieyue/step-3.5-flash。

填表单：在OpenMAIC首页的配置向导里，新建一个LLM模型，按下面这个抄作业：
1. API模式：选 OpenAI协议
1. Base URL：填 https://maas-api.lanyun.net/v1
2. API Key：填你刚复制的蓝耘Key
3. Model Name：填 /maas/jieyue/step-3.5-flash