OpenMAIC 助手
一个引导式技能，帮你零门槛地使用、部署或二次开发 OpenMAIC——把任何主题或文档变成多智能体交互课堂。
技能明确要求所有状态变更操作前先确认，明确禁止在聊天中索取或代写 API Key，引导用户自行编辑本地配置文件，避免凭据进入对话；访问码仅从本地配置文件读取；无隐蔽数据外发。扣分项：Live Demo 模式将访问码作为 Bearer 头发送到外部服务 open.maic.chat（属功能必需但仍是外部传输），且回滚路径未系统化说明，未达满分。
SOP 分阶段结构清晰，generate-flow.md 含完整轮询规则、错误上报要求、feature detection（capabilities 探测）、以及'不通过改请求参数绕过配置错误'等失败反馈规则，输出格式规范。扣分项：静态评审未执行任何路径，仓库 CI 与单测覆盖的是产品代码而非技能 SOP 本身的关键路径，按静态校准不超过 10。
三种模式（Live Demo / 本地 / 二开）边界与触发条件明确，含 accessCode 存在时的自动路由及二开例外，明确中英双语和 language 字段，文档自带中文说明；核心服务 open.maic.chat 与 file.maic.chat 位于国内可达范围，本地模式也完全可行。扣分项：部分可选功能依赖境外 provider（Google/OpenAI 等），触发准确性仅有文字描述、无实测证据。
SKILL.md 采用渐进式披露（主文件 + 8 个 references 分层），仓库有 MIT LICENSE、SECURITY.md、详细 CHANGELOG、版本发布记录、明确的维护责任与更新路径（publish CI、package version 检查）。扣分项：技能目录本身无独立 changelog/版本号，SDK 版本以'current as of this writing'标注可能漂移。
生成流程、轮询、结果 URL 输出格式、配额与错误处理均明确，对用户直接可用价值高，比手工操作有明显边际价值。扣分项：静态评审无法验证生成结果的实际正确性与可用性，效果声明未经执行复核，按校准不超过 7，取 6。
关键声明大多可追溯到仓库文件（entry points 以文件+符号名给出、CI workflow 真实存在、包含单测/冒烟测试），事实与推断分离较好。扣分项：未执行任何复现，仓库测试覆盖产品而非技能关键路径，第三方独立验证证据不足，按静态校准不超过 5，取 4。
- 静态评审，未执行任何命令或生成流程；结论基于源文件阅读。
- Live Demo 模式需将访问码（sk- 前缀）以 Bearer 头发送至 open.maic.chat，请确认信任该托管服务后再使用。
- 部分可选功能（图像/视频生成、Web 搜索的多数 provider）依赖境外服务，中国大陆网络环境下可能不可达；OpenMAIC 支持多家国内 provider（智谱、MiniMax、通义、Kimi 等），建议优先配置。
- 技能目录本身没有独立版本号或 changelog；SDK 0.x 版本要求精确锁定，安装前请核对 registry 上的最新版本。
- 生产部署时 Next.js 公开 token（NEXT_PUBLIC_PERSISTENCE_TOKEN）可被任意访客提取，仅适用于 localhost 或可信网络，请勿用于公网多用户部署。
这个 Skill 能做什么，适合哪些场景？
openmaic 是 OpenMAIC 仓库自带的 OpenClaw 技能，充当一份'确认优先'的分阶段 SOP：从选择云端 Live Demo、本地部署或二次开发三种模式开始，逐步引导克隆仓库、选择启动方式、配置服务端模型密钥、验证服务健康，最后提交异步课堂生成任务并轮询结果。它刻意避免黑盒自动化——任何改变状态的操作（含读取本地 PDF）都先请求确认，且不会替用户把 API 密钥写进配置文件。生成课堂由 OpenMAIC 服务端完成，该技能只负责编排流程。
读取 ~/.openclaw/openclaw. 中 skills.entries.openmaic.config 的 accessCode/repoDir/url 默认值；根据用户意图路由到 Live Demo（open.maic.chat，sk- 开头访问码）、本地运行或二开（@openmaic/* SDK）三条分支；本地分支下引导 git clone、pnpm install、选择启动方式（dev / build+start / Docker）、指导用户自行编辑 .env.local 或 server-providers.yml 配置至少一个 LLM 密钥，并可选启用联网搜索、图像、视频、TTS；用 GET {url}/api/health 验证服务；提交课堂生成作业（确认后才读本地 PDF），以稀疏轮询跟踪异步任务直至完成并返回课堂链接。
- 想零本地部署快速体验的用户：在 open.maic.chat 获取 sk- 访问码存入配置后，直接说'teach me quantum physics'即生成课堂
- 自托管用户：想在私有环境跑 OpenMAIC，由技能逐步引导克隆、配密钥、启动并健康检查
- 二次开发者：想 fork 仓库或用 @openmaic/* SDK 构建衍生产品，技能直接路由到扩展分支
- 聊天应用用户：通过 OpenClaw 在飞书、Slack、Telegram 等消息应用里直接生成课堂，不碰终端
- 有本地教材 PDF 的教师：技能在读取 PDF 前会请求确认，然后上传生成完整课程
这个 Skill 有哪些优点和局限？
- 三种使用模式（云端 Demo / 自托管 / 二开）都有明确路由，新手和高级用户都能各取所需
- 确认优先的设计：不擅自改状态、不读取本地文件、不碰 API 密钥，安全边界清晰
- 访问码一旦配置即自动跳过模式选择，回到二开意图的用户会被正确分流
- 自托管支持 17+ 模型提供商及 Ollama、Lemonade 本地模型，密钥完全由服务端配置掌控
- 本地模式前置条件较多：Node.js >= 20、pnpm >= 10、至少一个 LLM 密钥，配错会在生成阶段失败
- 生成是异步长任务，会话若在完成前结束只能稀疏轮询，用户体验有等待成本
- SKILL.md 只包含流程编排，具体细节分散在 references/ 各文档中，源材料未展示这些文件内容
- 仓库本身从 AGPL-3.0 改为 MIT 仅在 v0.3.0 起，早期版本许可不同；packages/mathml2omml 仍为 LGPL-3.0-or-later
如何安装这个 Skill？
方式一（ClawHub）：clawhub install openmaic。方式二（手动复制）：mkdir -p ~/.openclaw/skills && cp -R /path/to/OpenMAIC/skills/openmaic ~/.openclaw/skills/openmaic。可选：在 ~/.openclaw/openclaw. 的 skills.entries.openmaic.config 下配置 accessCode（云端模式）或 repoDir + url（本地模式）。源文档未提供 Windows 特定安装说明。
如何使用这个 Skill？
安装后直接向助手提出需求，例如'teach me quantum physics'或'install OpenMAIC skill'。技能按 SOP 走：先问使用模式（配置了 accessCode 则默认 Live Demo，但二开意图不会走捷径）；本地模式会逐阶段确认——克隆/复用仓库、选启动方式、你亲自编辑密钥配置文件、验证 /api/health；最后清晰地说'生成课堂'即可提交作业，技能轮询并返回原始课堂链接。每个状态变更前都会请求确认。