Openmaic

核心用法

OpenMAIC Skill 是一套分阶段确认式标准作业程序，用于引导用户完成 OpenMAIC（OpenClaw 旗下 AI 课堂生成平台）的部署与使用。流程分为 6 个阶段：

1. 模式选择 — 检测本地配置文件中的 accessCode，存在则直接进入托管模式；否则询问用户选择「托管快速启动」或「本地部署」
2. 代码获取 — 本地模式下克隆仓库或复用现有目录
3. 启动模式 — 选择并配置合适的启动方式
4. 密钥配置 — 指导用户手动编辑服务端配置文件配置 API 提供商密钥，不代写敏感信息
5. 服务启动与验证 — 启动服务并通过健康检查端点确认状态
6. 课堂生成 — 支持从需求文本或 PDF 文件生成 AI 课堂，提交后进入轮询等待完成

显著优点

• 安全设计优先：强制分阶段确认，任何状态变更操作前必须获得用户明确授权；API 密钥始终由用户自行配置文件，不经过聊天界面传输
• 配置感知：自动读取 ~/.openclaw/openclaw.json 中的预设参数，减少重复输入
• 双模式灵活：托管模式零部署快速体验，本地模式完全自主可控
• 防误操作：本地文件读取（如 PDF）需单独确认，生成长时任务在首次明确请求后无需二次确认

潜在局限

• 流程较为冗长，不适合追求一键极速部署的高级用户
• 本地模式依赖用户具备基础命令行与配置文件编辑能力
• 长时生成任务可能因轮询间隔策略导致状态反馈延迟

适合人群

• 教育机构技术人员、开发者、AI 教学设计师
• 需要合规安全部署（不泄露 API 密钥到聊天日志）的企业用户
• 首次接触 OpenMAIC 需要保姆级引导的新手

常规风险

• 本地配置文件权限管理不当可能导致 accessCode 泄露
• 服务端 API 密钥配置错误会导致生成任务失败，需返回第 4 阶段重配
• 托管模式依赖外部服务可用性，存在网络依赖风险

核心用法

OpenMAIC Skill 是一款纯指导型部署助手，专为清华 OpenMAIC 智能课堂生成器提供分阶段标准作业程序（SOP）。用户可通过两种模式使用：

• 托管模式：使用 open.maic.chat 官方服务，仅需 access code，零本地配置
• 本地模式：克隆 GitHub 仓库，自主配置 LLM 服务商 API 密钥并运行服务

Skill 采用严格确认机制：每阶段需用户确认后才推进，状态变更操作（如克隆仓库、启动服务、提交生成任务）均需显式授权。

显著优点

1. 安全设计优先：明确禁止在聊天中收集 API 密钥，强制引导用户编辑本地配置文件（.env.local/server-providers.yml），从源头降低凭证泄露风险
2. 分阶段可控流程：6 个清晰阶段（模式选择→仓库准备→启动模式→密钥配置→服务验证→课堂生成），每步可中断、可回退
3. 配置持久化：支持 ~/.openclaw/openclaw.json 预置默认参数，重复使用时跳过冗余交互
4. 官方可信来源：所有网络请求指向 GitHub 官方仓库及 open.maic.chat 域名，TLS 1.3 加密传输

潜在缺点与局限性

• 非自动化部署：需用户手动执行克隆、编辑配置、启动服务等操作，对纯 CLI 用户不够"一键式"
• 依赖外部服务：课堂生成功能必须连接 OpenMAIC 服务器，无法完全离线运行
• 社区维护级别：来源可信度 T3，虽通过 A 级安全认证，但缺乏企业级 SLA 保障
• 无实时密钥注入：虽为安全设计，但对希望快速体验的用户增加了操作步骤

适合人群

• 教育工作者、开发者希望私有化部署 AI 课堂生成能力
• 对 API 密钥管理有合规要求的企业或机构用户
• 熟悉命令行操作、能接受手动配置的技术用户

常规风险

| 风险类型 | 级别 | 说明 |

|---------|------|------|

| 代码执行风险 | 极低 | 纯 Markdown，无可执行代码 |

| 凭证泄露风险 | 低 | Skill 本身不收集密钥，但用户自行配置时可能误操作 |

| 服务可用性风险 | 中 | 依赖 open.maic.chat 及第三方 LLM 服务商 |

| 数据隐私风险 | 低 | PDF 上传至 OpenMAIC 服务器解析，需确认服务商隐私政策 |

建议：生产环境使用前审查 server-providers.yml 配置，启用最小权限 API 密钥，定期轮换凭证。