🔥 清华 OpenMAIC 保姆级教程

一、五大核心优势

1. 免安装免登录，网页即开即用、零门槛
2. 完全开源免费，支持本地私有化部署
3. 多角色实时互动：讲课 + 提问 + 陪学
4. 支持 PPT/HTML 一键导出离线保存
5. 可自定义 AI 性格、音色、功能权限

二、四层分级使用教程

第一层 小白版｜网页直接用

1. 访问官网：https://openmaic.ai
2. 无需注册登录，直接输入学习需求（知识点 / 课程主题）
3. 等待 15–30 分钟生成课程，小文件更快
4. 进入虚拟教室听课，结束可导出 PPT/HTML

第二层 进阶版｜接入第三方 AI 提速

1. 注册蓝耘 Lanyun，获取 API Key
2. 配置参数：
   • 协议：OpenAI 协议
   • Base URL：https://maas-api.lanyun.net/v1
   • 模型：/maas/jieyue/step-3.5-flash
    
3. 成本：单节课约 7–14 元，远低于线下家教

第三层 高阶版｜本地私有化部署

1. 前置环境：Node.js (v20+)、Git、Docker Desktop
2. 部署命令：

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

3. 编辑.env.local填入自有 API Key，执行pnpm dev
4. 本地访问：http://localhost:3000

注意：无官方免费 Key、需自备；部分依赖需科学上网；大文件生成耗时更长

5. 专属玩法：自定义 AI 人设、更换 TTS 音色、拓展图生 / 联网搜索等功能

第四层 开发者版｜二次开发定制

• 技术栈：Next.js+React+TS、LangGraph、Docker Compose
• 可开发：接入全品类大模型、新增 AI 角色、集成飞书 / 微信 / 社群、遵循 AGPL-3.0 协议商用开发

三、避坑实用指南

1. 生成慢：文件控制在 10M 内，接入第三方模型加速
2. 网页卡顿：用 Chrome 浏览器、刷新重试，或改用本地部署
3. 内容跑偏出错：指令写详细，上传参考文档限定讲解范围
4. API 配置失败：Base URL 必须带/v1、Key 无空格；备选可用 Gemini 1.5-flash

四、人群选型建议

• 小白：直接用网页版零配置体验
• 进阶：接入蓝耘模型，低成本大幅提升体验
• 机构 / 隐私党：本地私有化部署，数据不外泄
• 开发者：拉 GitHub 源码，自主定制做产品

官方直达链接

• 在线体验：https://openmaic.ai
• 开源源码：https://github.com/THU-MAIC/OpenMAIC