openmaic
Skill1 starsChanged 38 days agoMITView on GitHub
OpenMAIC assistant for setting up, generating, and extending OpenMAIC. Use when the user wants to use OpenMAIC, generate a multi-agent interactive classroom, or build on / extend / customize OpenMAIC and its @openmaic/* SDK (secondary development, 二开) — covers Live Demo or local setup, startup modes, provider keys, classroom generation, and secondary development (forking, providers/storage/themes, routes, or the renderer/editor).
1 other project uses a version of this, 1 of them edited.
Adopted by
Most recently taken up by
- THU-MAIC/OpenMAICedited, first seen Oct 8, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 1
- THU-MAIC/OpenMAIC★ 44k87% same
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository28 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- audience-report-formattingSkill
- baidu-netdiskSkill
- baidu-netdisk-syncspace-recoverySkill
- china-proxySkill
- chrome-devtoolsSkill
- claude-maintenanceSkill
- cloudcli-device-onboardingSkill
- codex-dream-skin-fixSkill
- content-research-writerSkill
- git-history-cleanupSkill
- github-aliyun-deploySkill
- github-kbSkill
- google-flow-story-videoSkill
- mac-windows-lanSkill
- meeting-materials-uploadSkill
- meeting-reimbursement-auditSkill
- opus-code-videoSkill
- seedance-short-dramaSkill
- spec-modeSkill
- video-courseware-extractorSkill
- wechat-account-bookmarksSkill
- wechat-ai-model-writerSkill
- wechat-android-shortcutsSkill
- wechat-ios-shortcutsSkill
- wechat-medical-writerSkill
- wechat-tech-writerSkill
- wps-presentation-batchSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
25 rules. About 0 are common, 20 are distinctive, and 5 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈20
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 10
Use this as a guided, confirmation-heavy SOP.
- Distinctive: line 15
Before any state-changing action, ask for confirmation.
- Distinctive: line 16
If local state already exists, show what you found and ask whether to keep it.
- Distinctive: line 17
Do not assume the OpenClaw agent's own model or API key will be reused by OpenMAIC.
- Distinctive: line 20
Only OpenMAIC server-side config files may control provider selection and defaults.
- Distinctive: line 21
Do not default to asking the user to paste API keys into chat.
- Distinctive: line 22
Prefer guiding the user to edit local config files themselves.
- Distinctive: line 23
Do not offer to write API keys into config files on the user's behalf.
- Distinctive: line 25
Keep confirmations for local file reads such as reading a PDF from disk.
- Very specific: line 29
If present, read defaults from ~/.openclaw/openclaw.json under:
- Very specific: line 48
If accessCode is present, default to Live Demo mode and skip the mode-selection prompt — unless the user's intent is to extend/build on …
- Very specific: line 49
Use repoDir and url only as defaults for local mode.
- Very specific: line 58
If no accessCode in config (or the extend exception above applies), ask the user how they want to use OpenMAIC:
- Distinctive: line 64
If the user chooses Live Demo mode, load references/live-demo.md and skip phases 1–4.
- Distinctive: line 65
If the user chooses local mode, proceed to phase 1 as usual.
- Distinctive: line 66
If the user chooses to extend/build on OpenMAIC, load references/extend.md and skip the setup/generation phases.
- Distinctive: line 72
Use this when the user has not installed OpenMAIC yet or when you need to confirm which local checkout to use.
- Distinctive: line 78
Use this after the repo location is confirmed.
- Distinctive: line 86
After the core LLM key is configured, ask the user if they want to enable optional features (web search, image generation, video …
- Very specific: line 90
After the user has chosen a startup mode and configured keys, start OpenMAIC using the chosen method, then verify the service with GET …
- Distinctive: line 100
Keep each step short and explicit.
- Distinctive: line 101
Prefer 2-3 concrete options when the user must choose.
- Distinctive: line 102
Always include the recommended option first and explain why in one sentence.
- Distinctive: line 103
After a step completes, say what changed and what the next confirmation is for.
- Distinctive: line 104
When returning a classroom link, place the raw absolute URL on its own line with no bold, markdown link syntax, code formatting, or tables.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
OpenMAIC Skill
Use this as a guided, confirmation-heavy SOP. Do not compress the whole setup into one reply and do not perform state-changing actions without explicit user confirmation.
Core Rules
- Move one phase at a time.
- Before any state-changing action, ask for confirmation.
- If local state already exists, show what you found and ask whether to keep it.
- Do not assume the OpenClaw agent's own model or API key will be reused by OpenMAIC.
- OpenMAIC classroom generation uses OpenMAIC server-side provider config.
- This skill must not rely on any request-time model or provider overrides.
- Only OpenMAIC server-side config files may control provider selection and defaults.
- Do not default to asking the user to paste API keys into chat.
- Prefer guiding the user to edit local config files themselves.
- Do not offer to write API keys into config files on the user's behalf.
- Once setup is complete and the user clearly asks to generate a classroom, do not ask for a second confirmation before submitting the generation job.
- Keep confirmations for local file reads such as reading a PDF from disk.
Optional Skill Config
If present, read defaults from ~/.openclaw/openclaw.json under:
{
"skills": {
"entries": {
"openmaic": {
"enabled": true,
"config": {
"accessCode": "sk-xxx",
"repoDir": "/path/to/OpenMAIC",
"url": "http://localhost:3000"
}
}
}
}
}- If
accessCodeis present, default to Live Demo mode and skip the mode-selection prompt — unless the user's intent is to extend/build on OpenMAIC (see the exception in Phase 0). - Use
repoDirandurlonly as defaults for local mode. - Still confirm before acting.
SOP Phases
0. Choose Mode
First check skill config for accessCode. If present, announce that a stored access code was found and proceed directly to Live Demo mode (load references/live-demo.md, skip phases 1–4). Do not ask the user to paste the code again. Exception: if the user's stated intent is to extend / build on / customize OpenMAIC or consume the @openmaic/* SDK (二次开发 / 二开 / SDK), do not auto-shortcut — go to the extend branch below regardless of accessCode. A returning Live Demo user who now wants to do 二开 should be routed to extend, not silently sent back to Live Demo.
If no accessCode in config (or the extend exception above applies), ask the user how they want to use OpenMAIC:
- Use the OpenMAIC Live Demo (recommended for quick start) — The cloud edition: the version officially deployed and hosted by the OpenMAIC team at open.maic.chat. Requires an access code (starts with
sk-). Get yours by signing in at https://open.maic.chat, clicking your account in the top-right corner, opening "访问码设置" (access code settings), and generating a code; then add it to~/.openclaw/openclaw.jsonunderskills.entries.openmaic.config.accessCode. No local setup needed. - Run locally — Clone the repo, configure provider keys, and run on your machine.
- Extend or build on OpenMAIC (二次开发) — Fork the repo and customize the product, or consume the
@openmaic/*SDK to build something new.
If the user chooses Live Demo mode, load references/live-demo.md and skip phases 1–4. If the user chooses local mode, proceed to phase 1 as usual. If the user chooses to extend/build on OpenMAIC, load references/extend.md and skip the setup/generation phases.
1. Clone Or Reuse Existing Repo
Load references/clone.md.
Use this when the user has not installed OpenMAIC yet or when you need to confirm which local checkout to use.
2. Choose Startup Mode
Load references/startup-modes.md.
Use this after the repo location is confirmed. Present the available startup modes, recommend one, and wait for the user's choice.
3. Configure Provider Keys
Load references/provider-keys.md.
Use this before starting classroom generation. Recommend a provider path and tell the user exactly which config file to edit themselves. If generation later fails due to provider/model/auth issues, return to this phase and direct the user to update the same server-side config files.
After the core LLM key is configured, ask the user if they want to enable optional features (web search, image generation, video generation, TTS). Each requires its own provider key — see the "Optional Features" section in provider-keys.md.
4. Start And Verify OpenMAIC
After the user has chosen a startup mode and configured keys, start OpenMAIC using the chosen method, then verify the service with GET {url}/api/health.
5. Generate A Classroom
Load references/generate-flow.md.
Use this only after the service is healthy. Confirm before reading local PDFs. If the user has already clearly asked to generate, do not ask for a second confirmation before submitting the generation job, and then follow the polling loop until it succeeds or fails. Only send the supported content fields for generation requests. For long-running jobs, prefer sparse polling and tell the user to check back later if the turn ends before completion.
Response Style
- Keep each step short and explicit.
- Prefer 2-3 concrete options when the user must choose.
- Always include the recommended option first and explain why in one sentence.
- After a step completes, say what changed and what the next confirmation is for.
- When returning a classroom link, place the raw absolute URL on its own line with no bold, markdown link syntax, code formatting, or tables.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

