核心用法
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 阶段重配
- 托管模式依赖外部服务可用性,存在网络依赖风险