这个 Skill 能做什么,适合哪些场景?
这是 OpenMAIC(开放多智能体互动课堂)的官方 OpenClaw 技能。它以分阶段、需逐步确认的 SOP 方式,带你完成三种路径之一:使用官方托管的 Live Demo(凭 sk- 开头的访问码)、本地自部署(克隆、配置厂商密钥、启动),或基于 @openmaic/* SDK 做二次开发。课堂生成由 OpenMAIC 服务端的厂商配置驱动,技能明确要求用户自行编辑本地配置文件,不代写 API 密钥。适合想在飞书、Slack、Telegram 等聊天应用里直接生成课堂的用户。
检查技能配置中的访问码(accessCode),有则直接进入 Live Demo 模式;若意图是二开则仍走扩展分支。本地模式:引导克隆或复用已有仓库、选择启动方式(pnpm dev / 构建启动 / Docker)。指导用户自行编辑服务端厂商配置文件,配置核心 LLM 密钥及可选的搜索、图像、视频、TTS 功能。启动服务后通过 GET /api/health 验证健康状态。提交异步课堂生成任务并轮询直至成功或失败,返回课堂链接。扩展模式:加载 references/extend.md,指导 fork 定制或使用 @openmaic/* SDK。
- 想在聊天应用里零部署体验的用户:从 open.maic.chat 获取访问码写入配置,直接生成课堂
- 想自部署的开发者:需要克隆仓库、配置至少一个 LLM 密钥、用 pnpm 或 Docker 启动
- 想基于 @openmaic/* SDK(DSL/渲染器/导入器)做二次开发或自定义厂商、存储、主题、路由的开发者
- 企业内网培训场景:需要离线导出课堂(.maic.zip 或资源包,内联外部资源)
- 不愿自行编辑配置文件、期望助手代填 API 密钥的用户——该技能明确拒绝代写密钥
- 没有 Node.js 20+ 和 pnpm 10+ 环境且不打算用 Live Demo 的用户
- 只想用本技能而不配置任何 LLM 厂商密钥的用户——课堂生成至少需要一个厂商密钥(Live Demo 模式则需访问码)
如何安装这个 Skill?
- 静态评审,未执行任何命令或生成流程;结论基于源文件阅读。
- 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 或可信网络,请勿用于公网多用户部署。
- Shell / 命令行
- 网络访问
- 本地文件系统
Node.js >= 20pnpm >= 10OpenMAIC repoat least one LLM provider API key
源文档给出的是 OpenClaw/ClawHub 安装方式:
OpenClaw
clawhub install openmaic或手动复制:
mkdir -p ~/.openclaw/skills
cp -R /path/to/OpenMAIC/skills/openmaic ~/.openclaw/skills/openmaic如何使用这个 Skill?
安装后,把下面任意一句发给 Agent 即可触发:
- 帮我安装 OpenMAIC 技能,然后教我量子物理
- 我在 open.maic.chat 拿到了访问码,帮我配置后用 Live Demo 生成一节 Python 入门课
- 我想自部署 OpenMAIC:克隆仓库、配置 OpenAI 密钥并用 Docker 启动
- 我想基于 @openmaic/* SDK 做二次开发,自定义主题和路由
安装后对助手说出使用意图即可触发。流程为分阶段确认式 SOP:
- 技能读取 ~/.openclaw/openclaw. 中 skills.entries.openmaic.config 的 accessCode / repoDir / url 作为默认值;
- Phase 0 让你在 Live Demo(推荐,凭访问码免本地部署)、本地运行、二次开发三种模式间选择;
- 本地模式依次走克隆→启动方式→厂商密钥→健康检查→生成课堂五个阶段,扩展模式则加载 extend.md 跳过部署阶段;
- 每个改变状态的操作前都会请求确认,但一旦你明确要求生成课堂,不会重复确认。
这个 Skill 有哪些优点和局限?
- 三种使用路径覆盖从零体验、自部署到 SDK 二开的完整梯度
- 确认式 SOP 设计,每步透明,无黑盒自动化
- 密钥安全设计合理:引导用户自己编辑本地配置,不要求往聊天里粘贴密钥
- 可选功能丰富:网络搜索、图像/视频生成、TTS 均可按需配置
- 本地模式前置条件较多:Node.js 20+、pnpm 10+、克隆仓库、至少一个 LLM 密钥
- 课堂生成本身是异步长任务,需轮询等待,可能需要稍后回来查看结果
- 技能依赖 OpenClaw 的技能机制与配置文件结构,换平台需适配
- 自身不包含自动化测试套件的证据
这个 Skill 与同类方案有什么区别?
与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| OpenMAIC 多智能体互动课堂助手 本页 | 65 · 推荐 | ★ 41k | 11 天前 | MIT |
| 添加 LLM 提供商(DeepChat 开发技能) | 56 · 谨慎使用 | ★ 6.4k | 12 天前 | Apache-2.0 |
| memU | 50 · 谨慎使用 | ★ 15k | 12 天前 | NOASSERTION |
| 模型目录刷新技能(agent-service-toolkit) | 60 · 推荐 | ★ 4.5k | 21 天前 | MIT |
| MAIC 导入器开发规范技能 | 52 · 谨慎使用 | ★ 41k | 11 天前 | MIT |
相对于直接浏览 OpenMAIC 仓库 README 手动部署,该技能把安装、配置、启动、生成压缩为带确认的分阶段引导;相对于部署在自己服务器上的裸 OpenMAIC 实例,它增加了 OpenClaw 聊天入口(飞书/Slack/Telegram 等 20+ 应用)和托管 Live Demo 模式。源文档还指向同类项目 MAIC-UI,作为功能更丰富、面向高质量教育 UI 生产的版本。
FollowSkills 如何评估这个 Skill?
技能明确要求所有状态变更操作前先确认,明确禁止在聊天中索取或代写 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。
点击维度查看打分理由
证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。
查看完整评分方法 →