核心用法
OpenMAIC Skill 是一套分阶段的标准作业程序（SOP），专门用于指导用户完成 OpenMAIC 的部署与课堂生成。流程分为五个明确阶段：模式选择（云端托管 vs 本地部署）、代码仓库克隆或复用、启动模式选择、API 密钥配置、服务启动验证，最终进入课堂生成功能。每个阶段均要求用户明确确认后方可推进，避免误操作。
显著优点
- 双轨部署灵活性：既支持零配置的云端托管模式（需 access code），也支持完全本地化的私有部署，满足不同安全需求场景。
- 确认驱动设计：每个状态变更节点（克隆代码、启动服务、读取本地文件等）强制要求用户确认，显著降低误操作风险。
- 密钥管理安全：明确禁止在聊天窗口中直接粘贴 API 密钥，强制引导用户手动编辑本地配置文件，避免敏感信息泄露。
- 配置隔离清晰：严格区分 OpenClaw agent 与 OpenMAIC 服务端的模型配置，避免配置混淆导致的服务异常。
潜在局限
- 流程较重：分阶段确认机制虽提升安全性，但可能让经验丰富的用户感到繁琐，不适合追求极速部署的场景。
- 依赖外部文档：大量功能依赖外部引用文档（如
references/clone.md、references/startup-modes.md等），若文档缺失或版本不匹配可能导致指引中断。 - 长任务阻塞风险：课堂生成可能为长时任务，虽采用稀疏轮询策略，但仍存在对话回合结束前无法返回结果的情况。
适合人群
- 教育机构技术管理员、需要私有化部署 AI 课堂生成能力的开发者、对数据主权有严格要求的企业用户。
常规风险
- 配置覆盖风险：若本地已存在 OpenMAIC 实例，需用户明确选择保留或覆盖，误操作可能导致既有数据丢失。
- 服务端配置错误：课堂生成失败多因 API 密钥或模型配置不当，需返回第 3 阶段重新调整服务端配置文件。
- 本地文件读取确认：读取用户本地 PDF 文件前必须获得明确授权，避免未经许可访问用户私有数据。