核心用法
OpenMAIC Skill 是一套引导式标准操作流程（SOP），帮助用户完成 OpenMAIC（OpenClaw 的 AI 课堂生成平台）的完整部署与使用。整个流程分为六个阶段，采用"一步一步确认"的模式，避免一次性压缩所有操作。
阶段 0 - 选择模式：优先检查 ~/.openclaw/openclaw.json 中是否存有 accessCode，若有则直接进入托管模式；否则让用户选择托管（推荐，无需本地部署）或本地运行。
阶段 1 - 代码仓库：克隆 OpenMAIC 仓库或复用已有本地副本，确认路径。
阶段 2 - 启动模式：根据场景推荐合适的启动方式（如 Docker、Node 直连等）。
阶段 3 - 配置服务商密钥：这是关键安全环节。Skill 不会要求用户在聊天中粘贴 API 密钥，而是指引用户自行编辑本地服务端配置文件。核心 LLM 密钥配置完成后，可选开启网络搜索、图像/视频生成、TTS 等功能，每项均需独立服务商密钥。
阶段 4 - 启动与验证：按选定方式启动服务，通过 GET /api/health 确认健康状态。
阶段 5 - 生成课堂：服务健康后，支持从文本需求或本地 PDF 生成结构化课堂。若用户已明确表达生成意图，提交任务前不再二次确认；随后进入轮询等待任务完成。
显著优点
- 确认密集型设计：每个状态变更前均要求用户确认，降低误操作风险
- 安全导向：明确禁止在对话中传输 API 密钥，强制本地文件配置
- 灵活双模式：托管模式零部署，本地模式完全可控
- 模块化可选功能：核心 LLM 与增强功能（搜索、多媒体生成）解耦配置
潜在缺点与局限性
- 流程较重：必须按阶段顺序执行，无法跳跃， impatient 用户可能感到繁琐
- 本地配置门槛：本地模式需要用户具备基本的 JSON 编辑和命令行操作能力
- 依赖外部服务商：生成质量与稳定性取决于用户配置的第三方 LLM/多模态服务商
- 无内置密钥托管：不提供加密密钥存储机制，依赖用户本地文件安全
- 长任务等待：课堂生成可能耗时较长，虽支持稀疏轮询，但仍需用户保持会话或主动检查
适合人群
- 需要将课程大纲/教材 PDF 快速转化为结构化 AI 课堂的教育工作者
- 希望完全掌控数据与模型选择的技术型用户（本地模式）
- 追求零运维快速试用的轻度用户（托管模式）
- 拥有多服务商 API 资源、愿意自行配置以换取灵活性的开发者
常规风险
| 风险类型 | 说明 |
|---------|------|
| 密钥泄露 | 尽管 Skill 禁止聊天粘贴，用户若误操作仍可能在其他场景暴露密钥；配置文件权限管理不当也存在本地泄露风险 |
| 服务商依赖 | 课堂生成失败常见于服务商配额耗尽、模型下线或认证过期，需返回阶段 3 重新配置 |
| 本地环境冲突 | Node 版本、端口占用、Docker 权限等问题可能导致启动失败 |
| 生成内容质量 | 依赖底层 LLM 能力，可能产生幻觉或不合适的教学内容，需人工审核 |
| 长任务中断 | 网络波动或会话超时可能导致生成任务状态丢失，建议重要任务保留本地备份 |
---
使用建议：首次使用建议尝试托管模式验证核心功能；确认需求稳定后再迁移至本地模式以获得更大自定义空间。始终将 API 密钥配置文件设置为仅用户可读权限（Unix: chmod 600）。