遇到一个陌生概念，普通聊天工具通常给出一段解释；OpenMAIC 则尝试把它变成一堂可以听讲、提问和动手操作的课。它的完整名称是 Open Multi-Agent Interactive Classroom，核心定位是开源多智能体互动课堂，而不是单纯的问答机器人或视频生成器。
对需要快速入门新知识的自学者、准备教学材料的老师，以及制作科普内容的创作者来说，它值得关注的地方是把“讲解、演示、练习”放到同一条学习流程里。以下介绍依据官网界面、官方文档和代码仓库整理，未进行付费课程生成或完整教学效果测试。
OpenMAIC 能做什么？
官方项目支持把主题或资料组织成包含幻灯片、测验、交互模拟和项目式学习活动的课堂。AI 老师与 AI 同学可以参与讲解和讨论，白板与语音让概念不必只停留在文字层面。课程制作也支持导出可编辑 PPTX 或交互 HTML，具体可用能力取决于版本和部署配置。查看官方项目说明。
官网展示的电子学、光合作用和凸透镜课程很能说明它的方向：如果学习者能够改变参数、观察结果，再解释为什么，比反复阅读一段定义更容易暴露理解上的空白。不过，“页面能互动”不等于“知识一定正确”，教师仍需检查公式、案例和答案。
经典课堂与 Pro 工作台
经典入口适合从一个明确主题快速开始。官网 v1.0 更新说明中的 Pro 工作台则更偏课程创作：通过对话规划连续课时、修改具体页面，并管理教学 Skill。两者可以理解为“先体验一堂课”和“持续打磨一套课”的不同工作方式，而不是默认都需要本地安装。
网页版使用教程
- 打开官网：进入 OpenMAIC 官网，按页面提示登录。第一次可先查看“发现”中的示例，判断它的呈现方式是否符合自己的学习需求。
- 写清目标：不要只输入“摄影”或“Python”。建议同时说明基础、时间、想解决的问题和期望练习，缩小一次课程的范围。
- 按需补充资料：使用附件入口提交自己有权使用的讲义或材料。文档能否解析取决于所选解析服务和支持格式；不要假设所有扫描件、音视频都能直接处理。
- 选择课堂方式：需要实验、参数变化或操作练习时，可尝试页面中的“深度交互”入口，再点击“进入课堂”。涉及额度或费用时，先阅读当次提示。
- 边学边检验：讲解过程中追问不理解的步骤，做完练习后用自己的话复述结论。发现事实或公式错误时，回到教材、论文或官方资料核实。
- 继续完善课程：制作课程时可在可用的 Pro 工作台中提出具体修改要求，例如增加一个反例、降低某页难度、把概念介绍改成练习。保存和导出前逐页检查。
附件格式、模型和启动方式可参考官方入门文档。
可直接尝试的学习提示词
我是一名刚接触 AI 视频的剪辑师。请用简体中文设计一堂 20 分钟的“AI 漫剧入门”课，先区分静态漫画、动态漫和分镜式短剧，再用一个三镜头案例说明脚本、角色一致性和镜头衔接。最后给我 3 道判断题，每题解释错误选项为什么不成立。对无法确认的工具功能请明确标注。
我完全不懂摄影曝光。请从快门、光圈和 ISO 的关系开始，用同一个室内拍摄场景逐步讲解。安排一个每次只改变一个参数的练习，让我先预测结果，再看解释。
这些是编辑建议的输入示例，不是平台已经生成的课程或效果承诺。更好的检验方法是看自己是否能完成练习，而不只是看课件是否漂亮。
本地安装教程
只想体验课程，可以直接使用网页版。需要自行配置模型、修改代码或管理部署时，再考虑本地安装。核对时间为 2026 年 9 月 3 日：部分在线文档仍写 Node.js 20.9 起，但当前 package.json要求 Node.js 22.19.0 或更高版本，项目使用 pnpm 10.28.0，安装时应遵循所下载版本的要求。
1. 准备环境并下载项目
先安装 Git、符合要求的 Node.js 和 pnpm。下面是教程命令，不会自动在读者电脑执行：
npm install -g pnpm@10.28.0
git clone https://github.com/THU-MAIC/OpenMAIC.git
cd OpenMAIC
pnpm install
cp .env.example .env.local最后一条命令适用于 macOS/Linux；Windows PowerShell 可使用 Copy-Item .env.example .env.local。首次安装会构建项目所需的工作区包，请等待完成。
2. 配置模型服务
打开新建的 .env.local，按照模板填入自己使用的服务。例如选择 DeepSeek 时配置对应密钥；不需要把模板中的所有服务都填满：
DEEPSEEK_API_KEY=替换为你自己的密钥如使用已运行的本地 Ollama，可按官方配置设置 OLLAMA_BASE_URL=http://localhost:11434/v1，并确保服务中已有可用模型。语言模型、语音、图片和资料解析是不同能力，配置了聊天模型不代表其他能力也已开通。完整变量请查阅模型与功能配置文档。不要把真实密钥写入公开仓库或文章评论。
3. 启动并做小规模验证
pnpm dev在浏览器打开 http://localhost:3000，先用一个简短主题验证课程生成。确认模型连接正常后，再逐项启用语音、搜索或资料解析。正式构建可使用：
pnpm build
pnpm start4. Docker 简化部署
如果已经安装 Docker Compose，可在项目目录准备好 .env.local 后使用官方命令：
docker compose up --build这是配置完成后的单命令启动，不是免配置安装。Docker 容器里的 localhost 指容器自身；模型运行在宿主机时，要按部署文档调整地址。公开视频服务还需配置访问控制、HTTPS 和真实用户认证，不能直接把开发用持久化令牌当作多用户权限系统。
官方 Skill 一键安装与用法
已具备 OpenClaw 和 ClawHub 命令环境的用户，可以按官方 README 安装 OpenMAIC Skill：
clawhub install openmaic安装后，可以对助手说：“使用 OpenMAIC，帮我做一堂面向零基础学生的摄影曝光课，包含一个案例和三道练习题。”随后选择托管模式或自部署模式。托管模式需要登录官网，在账户的“访问码设置”中生成访问码并按 Skill 文档配置；安装 Skill 本身并不会自动获得模型额度。
其他兼容的工作台可按照各自的导入方式加载仓库 skills/openmaic/ 整个目录，保留其中的参考文件，不要只复制一个标题或片段。具体流程以官方 Skill 说明为准。
费用、数据与适用人群
当前仓库采用 MIT 许可证，但代码开源不意味着在线托管、云端模型、图片或语音调用永久免费。官网额度、活动和账户权限可能变化；自部署也要计算模型、服务器和存储成本，不能把首页的活动奖励当作永久免费政策。
我更建议把它当作“可交互的学习草稿”。学生可以用它补概念，老师可以用它搭建课堂结构，科普创作者可以用它梳理讲解逻辑。考试标准答案、专业结论和对外发布的课件仍应由人审核。上传学生资料、客户文档或未公开讲义之前，也应确认授权并做好脱敏。
推荐理由：如果你希望 AI 不只是把答案写出来，而是围绕一个问题安排讲解、练习和讨论，OpenMAIC 提供了一个清晰的尝试入口。先跑通一堂短课，再决定是否制作整套课程，比一开始就提交大量材料更容易控制质量和成本。
