核心用法
OpenMAIC Skill 是一套严格遵循确认机制的渐进式配置流程，用于部署 OpenClaw 旗下的 OpenMAIC 课堂生成服务。技能采用分阶段 SOP 设计，强制在每个状态变更节点获得用户明确确认，禁止一次性压缩全部步骤。
双模式架构：
- 托管模式：使用
accessCode直连官方服务，零本地部署 - 本地模式：完整克隆仓库、配置多服务商 API 密钥、自主运行
五阶段流程：
1. 模式选择（检查配置文件中的 accessCode）
2. 仓库克隆或复用本地副本
3. 启动模式选择（标准/容器化等）
4. 服务商密钥配置（核心 LLM + 可选功能：搜索/图像/视频/TTS）
5. 服务启动验证（健康检查 GET /api/health）
6. 课堂生成（支持 PDF 解析与需求描述输入）
显著优点
- 安全优先设计：禁止自动代写 API 密钥到配置文件，强制用户手动编辑
- 状态隔离：明确区分服务端配置与请求时模型覆盖，避免配置污染
- 灵活接入：配置文件路径
~/.openclaw/openclaw.json支持默认参数预设 - 长任务友好：生成任务采用稀疏轮询机制，支持异步检查
- 输出规范：课堂链接以裸 URL 形式单独成行，便于直接复制
潜在缺点与局限性
- 交互成本高：每一步需显式确认，对熟练用户可能显得冗余
- 本地部署门槛：需自行管理多服务商密钥（OpenAI、Claude、搜索/图像等可选服务）
- 无自动回滚：配置失败时需手动返回对应阶段重试
- 依赖外部仓库：本地模式需稳定访问 GitHub 克隆 OpenMAIC
适合人群
- 需要批量生成结构化教学内容的教师、培训师
- 对数据主权有要求、倾向本地部署的技术用户
- 已持有 OpenMAIC 访问码、希望快速试用的轻量用户
- 具备基础 CLI/配置文件编辑能力的开发者
常规风险
| 风险类型 | 说明 |
|---------|------|
| 密钥泄露 | 技能虽禁止自动写入，但用户手动编辑时仍存在暴露风险 |
| 服务商配额 | 课堂生成可能消耗大量 LLM token，需监控用量 |
| 长任务超时 | 复杂 PDF 解析或视频生成可能超出单次会话周期 |
| 配置漂移 | 服务端配置与预期模型不一致时，生成结果可能偏离预期 |