OpenMAIC Assistant
A guided skill that gets you running, deploying, or extending OpenMAIC with zero friction — turning any topic or document into a multi-agent interactive classroom.
The skill mandates explicit confirmation before every state-changing action, forbids asking for or writing API keys into chat, guides users to edit local config files themselves, and reads access codes only from local config; no covert data flows. Deductions: Live Demo mode transmits the access code as a Bearer header to external open.maic.chat (functionally necessary but still external transmission), rollback paths are not systematically documented, so not full marks.
Phased SOP with clear structure; generate-flow.md contains full polling rules, error-surfacing requirements, capability feature detection, and explicit 'do not work around config errors via request overrides' failure-feedback rules, plus strict output format. Deductions: static review executed nothing; repo CI and unit tests cover product code, not the skill's own key paths — capped at 10 per static calibration.
Three modes (Live Demo / local / extend) with clear boundaries and trigger conditions, including accessCode auto-routing with the extend exception; bilingual with language field; core services open.maic.chat and file.maic.chat are reachable from mainland China and local mode works fully offline of cloud services. Deductions: optional features depend on overseas providers (Google/OpenAI etc.); trigger precision is described textually with no empirical evidence.
Progressive disclosure via SKILL.md plus eight layered references; repo has MIT LICENSE, SECURITY.md, detailed CHANGELOG, release history, and clear maintenance/update paths (publish CI, version-bump checks). Deductions: the skill folder itself has no independent changelog/version, and SDK versions are marked 'current as of this writing' and may drift.
Generation flow, polling, output URL format, quota and error tables are explicit and directly usable; clear marginal value over manual setup. Deductions: static review cannot verify actual correctness/usability of generated classrooms; capped at 7, scored 6.
Most claims trace to repo files (entry points given as file+symbol, real CI workflow with unit and smoke tests), with good fact/inference separation. Deductions: no executed reproduction, repo tests cover the product rather than the skill's key paths; capped at 5, scored 4.
- This is a static review; no commands or generation flows were executed. Conclusions are based on source reading only.
- Live Demo mode sends the sk-prefixed access code as a Bearer header to open.maic.chat; confirm you trust this hosted service before use.
- Several optional features (image/video generation, most web-search providers) rely on overseas services that may be unreachable from mainland China; OpenMAIC supports domestic providers (GLM, MiniMax, Qwen, Kimi, etc.) which are recommended first.
- The skill folder has no independent version or changelog; SDK 0.x versions must be pinned exactly — verify latest registry versions before installing.
- The NEXT_PUBLIC_ persistence token is compiled into public JS and extractable by any visitor; that mode is for localhost/trusted networks only, not public multi-user deployments.
What does this skill do, and when should you use it?
openmaic is the companion OpenClaw skill shipped inside the OpenMAIC repository, acting as a confirmation-heavy, phased SOP. It starts by routing you to one of three modes — the hosted Live Demo, a local deployment, or secondary development on the @openmaic/* SDK — then walks through cloning, choosing a startup mode, configuring server-side provider keys, health-checking the service, and finally submitting an async classroom generation job with polling. It deliberately avoids black-box automation: every state-changing action (including reading a local PDF) requires explicit confirmation, and it never writes API keys on your behalf. Classroom generation itself happens on the OpenMAIC server; the skill only orchestrates the workflow.
Reads defaults from ~/.openclaw/openclaw. under skills.entries.openmaic.config (accessCode/repoDir/url); routes by user intent to Live Demo (open.maic.chat, sk- access code), local run, or extend (SDK/fork) branches; in local mode guides git clone, pnpm install, startup-mode choice (dev / build+start / Docker), and directs you to edit .env.local or server-providers.yml yourself with at least one LLM key, plus optional web-search, image, video, and TTS providers; verifies the service via GET {url}/api/health; submits a classroom generation job (confirming before reading any local PDF), tracks the async task with sparse polling, and returns the raw classroom link.
- Zero-setup explorers: store an sk- access code from open.maic.chat in config, then say 'teach me quantum physics' to generate a classroom instantly
- Self-hosters: run OpenMAIC in a private environment with step-by-step guidance through clone, keys, startup, and health check
- Secondary developers: fork the repo or build on the @openmaic/* SDK — the skill routes directly to the extend branch
- Chat-app users: generate classrooms from Feishu, Slack, Telegram, and 20+ messaging apps via OpenClaw without touching a terminal
- Teachers with local PDFs: the skill confirms before reading the file, then uploads it to generate a full course
What are this skill's strengths and limitations?
- Three explicit mode routes (hosted demo / self-hosted / extend) serve both newcomers and advanced users
- Confirmation-first design: no unapproved state changes, no silent local file reads, never touches API keys — clear safety boundaries
- Once an access code is stored, mode selection is skipped automatically, yet users returning for secondary development are correctly re-routed
- Self-hosted mode supports 17+ model providers plus Ollama and Lemonade local models, with provider selection controlled entirely by server-side config
- Local mode has real prerequisites: Node.js >= 20, pnpm >= 10, and at least one LLM key — misconfiguration surfaces as generation failure
- Generation is an async long-running job; if the session ends early, only sparse polling is possible and the user must check back
- SKILL.md is a thin router; concrete details live in references/ files whose contents are not shown in the source material
- The repo moved from AGPL-3.0 to MIT only as of v0.3.0; packages/mathml2omml remains LGPL-3.0-or-later
How do you install this skill?
Option one (ClawHub): clawhub install openmaic. Option two (manual copy): mkdir -p ~/.openclaw/skills && cp -R /path/to/OpenMAIC/skills/openmaic ~/.openclaw/skills/openmaic. Optional: set accessCode (hosted mode) or repoDir + url (local mode) under skills.entries.openmaic.config in ~/.openclaw/openclaw.. No Windows-specific installation instructions are documented.
How do you use this skill?
After installation, just ask your assistant, e.g. 'teach me quantum physics' or 'install OpenMAIC skill'. The SOP proceeds: it asks your mode first (defaults to Live Demo if accessCode is configured, but secondary-development intent never takes that shortcut); local mode confirms each phase — clone/reuse repo, pick startup mode, you edit the key config files yourself, verify /api/health; then say clearly that you want to generate a classroom and the job is submitted without a second confirmation, with the skill polling and returning the raw absolute link. Every state change asks first.