Openmaic

核心用法

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 解析或视频生成可能超出单次会话周期 |

| 配置漂移 | 服务端配置与预期模型不一致时，生成结果可能偏离预期 |

核心用法

OpenMAIC Skill 是一款引导式标准操作流程（SOP）助手，用于帮助用户部署和使用 OpenMAIC 智能教室生成平台。采用分阶段确认机制，共包含 5 个主要阶段：选择运行模式（托管/本地）、克隆或复用代码仓库、选择启动模式、配置 LLM 提供商密钥、启动服务并验证、生成智能教室。Skill 严格遵循"单次确认"原则，每个状态变更操作前均需用户明确同意，且不会压缩多步骤为单次回复。

显著优点

1. 零代码风险：纯 Markdown 文档型 Skill，无可执行文件、无动态代码加载、无危险函数调用，静态分析得分 95
2. 安全密钥管理：明确禁止在聊天中收集 API 密钥，指导用户自行编辑本地配置文件（~/.env.local 或 server-providers.yml）
3. 强制用户确认：所有状态变更（克隆、安装、启动）均需显式确认，动态行为分析得分 90
4. 灵活双模式：支持托管模式（零配置快速开始）和本地模式（完全可控自建）
5. 清华开源背书：关联 THU-MAIC 开源项目，来源可信度 T2 级

潜在局限

1. 需手动配置：不提供自动化一键部署，用户需按指引手动编辑配置文件
2. 依赖外部服务：本地模式需用户自行申请 OpenAI/Claude 等 LLM API 密钥
3. 无实时协作：不支持多用户同时配置，需单会话逐步完成
4. 托管服务限制：托管模式依赖 open.maic.chat 服务可用性

适合人群

• 教育工作者需要快速生成 AI 辅助教学课程
• 开发者希望本地部署可控的 LLM 教室生成服务
• 对 API 密钥安全敏感、偏好手动配置的技术用户
• 清华 MAIC 社区用户及开源贡献者

常规风险

• API 密钥泄露风险：用户若未遵循指引，可能误将密钥粘贴至聊天窗口（Skill 已设计防护机制）
• 本地服务暴露：本地模式启动后若未配置访问控制，可能存在未授权访问风险
• 依赖服务稳定性：托管模式受 open.maic.chat 服务状态影响
• 长轮询超时：教室生成任务可能耗时较长，对话可能中断需用户稍后检查