LeoYeAI/agent-master-skills / skills/agi-farm
agi-farm
FlaggedInteractive setup wizard that creates a fully working multi-agent AI team on OpenClaw. One command bootstraps agents, SOUL.md personas, comms infrastructure (inboxes/outboxes/broadcast), cron jobs, auto-dispatcher (HITL + rate-limit backoff + dependency checking), and a portable GitHub bundle — all customized to team name, size (3/5/11 agents), domain, and frameworks (autogen/crewai/langgraph). Includes a React + SSE live ops dashboard with file-watcher (~350ms push latency) and persistent macOS LaunchAgent. Model-selection guidance built in. Commands: setup | status | rebuild | export | dashboard | dispatch
SKILL.md
View on GitHub---
name: agi-farm
description: >
Interactive setup wizard that creates a fully working multi-agent AI team on OpenClaw.
One command bootstraps agents, SOUL.md personas, comms infrastructure (inboxes/outboxes/broadcast),
cron jobs, auto-dispatcher (HITL + rate-limit backoff + dependency checking), and a portable
GitHub bundle — all customized to team name, size (3/5/11 agents), domain, and frameworks
(autogen/crewai/langgraph). Includes a React + SSE live ops dashboard with file-watcher
(~350ms push latency) and persistent macOS LaunchAgent. Model-selection guidance built in.
Commands: setup | status | rebuild | export | dashboard | dispatch
---
# agi-farm
Builds a complete multi-agent AI team on OpenClaw. One wizard, full team.
## Commands
| Command | What it does |
|---------|-------------|
| `/agi-farm setup` | Full wizard — agents, workspace, crons, bundle, GitHub |
| `/agi-farm status` | Team health: agents, tasks, cron status |
| `/agi-farm rebuild` | Regenerate workspace from existing bundle (preserves edits) |
| `/agi-farm export` | Push bundle to GitHub |
| `/agi-farm dashboard` | Launch live ops room — see [references/dashboard.md](references/dashboard.md) |
| `/agi-farm dispatch` | Run auto-dispatcher — see [scripts/auto-dispatch.py](scripts/auto-dispatch.py) |
---
## `/agi-farm setup`
Ask **one question at a time**. Do not proceed until confirmed.
### Step 1 — Team name
> "What should we call your team? (e.g. NovaCorp, TradingDesk — default: MyTeam)"
Store as `TEAM_NAME`.
### Step 2 — Orchestrator name
> "What's your orchestrator's name? (default: Cooper)"
Store as `ORCHESTRATOR_NAME`.
### Step 3 — Team size
> "How many agents?
> **3** — Minimal: Orchestrator + Researcher + Builder
> **5** — Standard: adds QA + Content
> **11** — Full stack: complete AGI system (recommended)"
Store as `PRESET`.
### Step 3.5 — Domain
> "What domain? software / trading / research / general (default) / custom"
If custom: ask for one-phrase description. Store as `DOMAIN`.
### Step 3.6 — Custom agents _(PRESET 3 or 5 only)_
> "Add a custom agent? (yes/no, default: no)"
If yes, collect per agent: `id`, `name`, `emoji`, `role`, `goal`. Max 3 custom agents.
Append to roster in Step 7 with `"template": "generic"`.
### Step 4 — Frameworks
> "Collaboration frameworks? autogen / crewai / langgraph / all / none"
Store as `FRAMEWORKS` list. `all` → `["autogen", "crewai", "langgraph"]`.
### Step 5 — GitHub
> "Create a GitHub repo for the bundle? yes / no"
Store as `CREATE_GITHUB`.
### Step 6 — Confirm
Show summary, ask "Shall I proceed? (yes/no)". If no → restart Step 1.
---
### Step 7 — Write `team.json`
```bash
mkdir -p ~/.openclaw/workspace/agi-farm-bundle/
openclaw agents list --json # use output to assign appropriate models per role
```
Use the `openclaw agents list` output to assign each agent a model appropriate for
its role. Write resolved model strings directly into the `"model"` fields.
**Model selection cheat sheet** (based on `openclaw agents list --json` output):
| Role | Recommended tier | Why |
|------|-----------------|-----|
| Orchestrator | High-capability (e.g. `sonnet`, `opus`) | Needs broad reasoning, delegation judgment |
| Solution Architect / Researcher | High-capability | Deep analysis + design |
| Implementation Engineer | Mid-tier (e.g. `glm-5`, `sonnet`) | Fast code gen; cost-efficiency matters |
| Debugger | High-capability (e.g. `opus`) | Root-cause analysis benefits from deep reasoning |
| Business Analyst / Knowledge | Mid-high (e.g. `gemini-2.0-pro-exp`) | Long-context research tasks |
| QA Engineer | Fast/cheap (e.g. `glm-4.7-flash`) | High volume, pattern-matching checks |
| Content / Multimodal | Multimodal-capable (e.g. `gemini-2.0-pro-exp`) | Vision + rich generation |
| R&D / Process Improvement | High-capability | Creative + structured experimentation |
> Tip: assign `opus` or `sonnet` to roles that make decisions; use `flash`/`glm-4.7-flash` for high-frequency reviewers to manage cost.
**3-agent roster:**
```json
{"team_name":"<TEAM_NAME>","orchestrator_name":"<ORCHESTRATOR_NAME>","preset":"3",
"domain":"<DOMAIN>","frameworks":<FRAMEWORKS_JSON>,"created_at":"<ISO_TIMESTAMP>",
"agents":[
{"id":"main", "name":"<ORCHESTRATOR_NAME>","emoji":"🦅","role":"Orchestrator", "goal":"Orchestrate the team, delegate tasks, synthesize results", "model":"<MODEL>","workspace":"."},
{"id":"researcher", "name":"Sage", "emoji":"🔮","role":"Researcher", "goal":"Research deeply and surface the insights that matter most", "model":"<MODEL>","workspace":"researcher"},
{"id":"builder", "name":"Forge", "emoji":"⚒️","role":"Builder", "goal":"Implement solutions cleanly and efficiently", "model":"<MODEL>","workspace":"builder"}
]}
```
**5-agent:** add to 3-agent roster:
```json
{"id":"qa", "name":"Vigil", "emoji":"🛡️","role":"QA Engineer", "goal":"Ensure every output meets quality standards","model":"<MODEL>","workspace":"qa"},
{"id":"content","name":"Anchor","emoji":"⚓", "role":"Content Specialist","goal":"Craft clear content that communicates complex ideas simply","model":"<MODEL>","workspace":"content"}
```
**11-agent roster:**
```json
[
{"id":"main", "name":"<ORCHESTRATOR_NAME>","emoji":"🦅","role":"Orchestrator", "goal":"Orchestrate specialists, delegate tasks, synthesize results", "model":"<MODEL>","workspace":"."},
{"id":"sage", "name":"Sage", "emoji":"🔮","role":"Solution Architect", "goal":"Design robust, scalable architectures", "model":"<MODEL>","workspace":"solution-architect"},
{"id":"forge", "name":"Forge", "emoji":"⚒️","role":"Implementation Engineer", "goal":"Implement clean, well-tested code efficiently", "model":"<MODEL>","workspace":"implementation-engineer"},
{"id":"pixel", "name":"Pixel", "emoji":"🐛","role":"Debugger", "goal":"Find the true root cause of any bug or failure", "model":"<MODEL>","workspace":"debugger"},
{"id":"vista", "name":"Vista", "emoji":"🔭","role":"Business Analyst", "goal":"Research deeply and surface the insights that matter most", "model":"<MODEL>","workspace":"business-analyst"},
{"id":"cipher","name":"Cipher", "emoji":"🔊","role":"Knowledge Curator", "goal":"Curate and surface knowledge so the team never forgets", "model":"<MODEL>","workspace":"knowledge-curator"},
{"id":"vigil", "name":"Vigil", "emoji":"🛡️","role":"QA Engineer", "goal":"Ensure every output meets quality standards", "model":"<MODEL>","workspace":"quality-assurance"},
{"id":"anchor","name":"Anchor", "emoji":"⚓", "role":"Content Specialist", "goal":"Craft clear content that communicates complex ideas simply", "model":"<MODEL>","workspace":"content-specialist"},
{"id":"lens", "name":"Lens", "emoji":"📡","role":"Multimodal Specialist", "goal":"Extract meaning from images, documents, and multimodal inputs", "model":"<MODEL>","workspace":"multimodal-specialist"},
{"id":"evolve","name":"Evolve", "emoji":"🔄","role":"Process Improvement Lead","goal":"Make the team better systematically through continuous improvement", "model":"<MODEL>","workspace":"process-improvement"},
{"id":"nova", "name":"Nova", "emoji":"🧪","role":"R&D Lead", "goal":"Turn hypotheses into proven capabilities through structured experimentation", "model":"<MODEL>","workspace":"r-and-d"}
]
```
---
### Step 8 — Generate workspace files
```bash
python3 ~/.openclaw/skills/agi-farm/generate.py \
--team-json ~/.openclaw/workspace/agi-farm-bundle/team.json \
--output ~/.openclaw/workspace/ \
--all-agents --shared --bundle
```
---
### Step 9 — Create OpenClaw agents
For each agent **except `main`** (skip if already exists):
```bash
openclaw agents add \
--agent <id> --name "<name>" --emoji "<emoji>" \
--model "<model>" \
--workspace "~/.openclaw/workspace/agents-workspaces/<workspace>"
```
Use `agent["model"]` from team.json directly.
---
### Step 10 — Register cron jobs
```bash
python3 ~/.openclaw/skills/agi-farm/scripts/register-crons.py \
--team-json ~/.openclaw/workspace/agi-farm-bundle/team.json
```
Timezone is read automatically from OpenClaw config. Skips any cron that already exists.
---
### Step 11 — Install frameworks
For each framework in `FRAMEWORKS`:
```bash
if [ ! -d ~/.openclaw/skills/<fw>-collab ]; then
TMP=$(mktemp -d)
git clone --depth 1 --filter=blob:none --sparse \
https://github.com/oabdelmaksoud/openclaw-skills.git "$TMP"
cd "$TMP" && git sparse-checkout set <fw>-collab
cp -r <fw>-collab ~/.openclaw/skills/ && rm -rf "$TMP"
fi
python3 ~/.openclaw/skills/<fw>-collab/build_agents.py --force 2>/dev/null || true
```
---
### Step 12 — GitHub (if chosen)
```bash
cd ~/.openclaw/workspace/agi-farm-bundle
git init -b main && git add . && git commit -m "feat: <TEAM_NAME> AGI farm"
gh repo create agi-farm-<TEAM_NAME_LOWER> --public --source . --remote origin --push
```
---
### Step 13 — Commit workspace
```bash
cd ~/.openclaw/workspace
git add -A && git commit -m "feat: <TEAM_NAME> AGI team — agi-farm setup complete"
```
---
### Step 14 — Initialize registries + health check
```bash
# Write TASKS.json and AGENT_STATUS.json
python3 - << 'EOF'
import json
from pathlib import Path
ws = Path.home() / ".openclaw/workspace"
team = json.loads((ws / "agi-farm-bundle/team.json").read_text())
(ws / "TASKS.json").write_text("[]")
(ws / "AGENT_STATUS.json").write_text(json.dumps(
{a["id"]: {"status": "available", "name": a["name"]} for a in team["agents"]}, indent=2))
print("✅ registries written")
EOF
# Health check
AGENTS=$(openclaw agents list --json 2>/dev/null | python3 -c "import json,sys; print(len(json.load(sys.stdin)))" || echo 0)
CRONS=$(openclaw cron list 2>/dev/null | grep -c "<TEAM_NAME_LOWER>" || echo 0)
[ -d ~/.openclaw/workspace/comms/inboxes ] && echo "✅ comms OK" || echo "❌ comms missing"
[ -f ~/.openclaw/workspace/TASKS.json ] && echo "✅ TASKS.json OK" || echo "❌ TASKS.json missing"
echo "✅ Agents: $AGENTS | Crons: $CRONS"
```
---
### Step 15 — Done
```
✅ <TEAM_NAME> AGI team is live!
Agents : <PRESET> (<AGENT_NAMES_LIST>)
Workspace: ~/.openclaw/workspace/
Bundle : ~/.openclaw/workspace/agi-farm-bundle/
GitHub : <URL if created>
Next: talk to <ORCHESTRATOR_NAME> · /agi-farm status · /agi-farm dashboard
```
---
## `/agi-farm status`
```bash
openclaw agents list --json | python3 -c "
import json,sys
for a in json.load(sys.stdin):
print(f' {a.get(\"identityEmoji\",\"🤖\")} {a.get(\"identityName\",a[\"id\"])}: {a.get(\"model\",\"?\")}')
"
python3 -c "
import json
from pathlib import Path
ws = Path.home() / '.openclaw/workspace'
tasks = json.loads((ws/'TASKS.json').read_text()) if (ws/'TASKS.json').exists() else []
t = [t for t in tasks if isinstance(t,dict)]
print(f' Tasks: {len(t)} total · {sum(1 for x in t if x.get(\"status\")==\"pending\")} pending · {sum(1 for x in t if x.get(\"status\")==\"needs_human_decision\")} HITL')
"
openclaw cron list 2>/dev/null | head -15
```
---
## `/agi-farm rebuild`
```bash
python3 ~/.openclaw/skills/agi-farm/generate.py \
--team-json ~/.openclaw/workspace/agi-farm-bundle/team.json \
--output ~/.openclaw/workspace/ \
--all-agents --shared --no-overwrite
```
`--no-overwrite` skips files that already exist, preserving manual edits.
Add `--force` (remove `--no-overwrite`) to overwrite everything.
---
## `/agi-farm export`
```bash
cd ~/.openclaw/workspace/agi-farm-bundle
git add -A
git commit -m "export: $(date +%Y-%m-%d)" 2>/dev/null || echo "Nothing to commit"
git push 2>/dev/null || echo "No remote — run /agi-farm setup first"
```
---
## `/agi-farm dashboard`
**React + SSE ops room.** File-watcher pushes live data to the browser in ~350ms on any workspace `.json` or `.md` change. Runs as a persistent macOS LaunchAgent — always on, auto-restarts on crash.
### Architecture
```
dashboard.py ← Python HTTP server (SSE + static)
├── WorkspaceWatcher watchdog file-watcher, 250ms debounce
├── SlowDataCache background thread — caches `openclaw agents list`
│ and `openclaw cron list` every 30s (each takes ~1-2s)
├── Broadcaster thread-safe SSE fan-out to all connected clients
└── /api/stream SSE endpoint — pushes full snapshot on every file change
dashboard-react/ ← Vite + React 18 + Recharts frontend
dist/ ← production build (served by dashboard.py)
src/
hooks/useDashboard.js SSE hook — auto-reconnects on disconnect
components/
Header.jsx live badge, stats, clock
Nav.jsx tab switcher
tabs/
Overview.jsx stats, budget bar, SLA alerts, agent grid, broadcast preview
Agents.jsx full agent cards — model, inbox, quality, credibility, cache age
Tasks.jsx filterable table, expandable rows, ticking deadlines, pagination
Velocity.jsx 7-day charts (Recharts), quality trend, task-type donut
Budget.jsx period bars, threshold markers, per-agent/model breakdown
OKRs.jsx objectives + KRs with progress bars
RD.jsx experiments, backlog, benchmarks
Broadcast.jsx terminal log, color-coded CRITICAL/BLOCKED/HITL
```
### Data sources (all real-time from workspace files)
| Field | Source file | Refresh |
|-------|-------------|---------|
| tasks, task_counts, sla_at_risk | `TASKS.json` | instant |
| agents (inbox, perf, status) | `AGENT_STATUS.json`, `AGENT_PERFORMANCE.json`, `comms/inboxes/` | instant |
| agent model, cron error/busy | `openclaw agents/cron list` | 30s cache |
| budget | `BUDGET.json` | instant |
| velocity | `VELOCITY.json` | instant |
| okrs | `OKRs.json` | instant |
| broadcast | `comms/broadcast.md` | instant |
| experiments / backlog | `EXPERIMENTS.json`, `IMPROVEMENT_BACKLOG.json` | instant |
| knowledge_count | `SHARED_KNOWLEDGE.json` | instant |
| memory_lines | `MEMORY.md` | instant |
### LaunchAgent (always-on)
The dashboard is registered as `ai.coopercorp.dashboard` and starts automatically at login.
```bash
# Status
launchctl list | grep coopercorp
curl -s http://localhost:8080/api/data | python3 -m json.tool | head -5
# Restart
launchctl stop ai.coopercorp.dashboard
launchctl start ai.coopercorp.dashboard
# Logs
tail -f /tmp/coopercorp-dashboard.log
tail -f /tmp/coopercorp-dashboard.err
# Disable / re-enable
launchctl unload ~/Library/LaunchAgents/ai.coopercorp.dashboard.plist
launchctl load ~/Library/LaunchAgents/ai.coopercorp.dashboard.plist
```
**URL**: http://localhost:8080
### Rebuild React frontend
```bash
cd ~/.openclaw/skills/agi-farm/dashboard-react
npm install # first time only
npm run build # outputs to dist/ — dashboard.py serves automatically
```
Full reference: [references/dashboard.md](references/dashboard.md)
---
## `/agi-farm dispatch`
```bash
# Dry-run (preview only)
python3 ~/.openclaw/skills/agi-farm/scripts/auto-dispatch.py
# Execute
python3 ~/.openclaw/skills/agi-farm/scripts/auto-dispatch.py --execute
```
Fires agent sessions for pending tasks, handles HITL notifications, stale task
resets, rate-limit backoff, and dependency checking. Cron (every 1 min):
```bash
* * * * * python3 ~/.openclaw/skills/agi-farm/scripts/auto-dispatch.py --execute \
>> ~/.openclaw/workspace/logs/auto-dispatch.log 2>&1
```
---
## Troubleshooting
### Setup issues
| Symptom | Fix |
|---------|-----|
| `generate.py` fails with `ModuleNotFoundError` | Run `pip3 install jinja2` |
| `openclaw agents add` says agent already exists | Safe to ignore — skip that agent |
| `gh repo create` fails | Run `gh auth login` first |
| Cron registration shows 0 crons added | Run `openclaw cron list` to check for duplicates; use `--force` flag on re-register |
| `git commit` fails in Step 13 | Run `git config --global user.email` and set name/email first |
### Runtime issues
| Symptom | Fix |
|---------|-----|
| Auto-dispatcher fires but agents don't respond | Check `logs/auto-dispatch.log`; verify `openclaw agents list` shows agents |
| Dashboard shows stale data | Restart LaunchAgent: `launchctl stop ai.coopercorp.dashboard && launchctl start ai.coopercorp.dashboard` |
| TASKS.json parse error | Validate JSON: `python3 -m json.tool ~/.openclaw/workspace/TASKS.json` |
| Agent stuck >30 min | Check broadcast.md for `[BLOCKED]` tags; reassign task manually |
| Rate-limit backoff too aggressive | Edit `RATE_LIMIT_BACKOFF_MIN` in `scripts/auto-dispatch.py` (default: 10 min) |
| `openclaw` not found in cron | Set `OPENCLAW_BIN=/path/to/openclaw` in the cron environment, or add `PATH=/opt/homebrew/bin:$PATH` |
### Recovery
```bash
# Re-run setup without overwriting existing files
python3 ~/.openclaw/skills/agi-farm/generate.py \
--team-json ~/.openclaw/workspace/agi-farm-bundle/team.json \
--output ~/.openclaw/workspace/ \
--all-agents --shared --no-overwrite
# Force full regeneration (overwrites everything)
python3 ~/.openclaw/skills/agi-farm/generate.py \
--team-json ~/.openclaw/workspace/agi-farm-bundle/team.json \
--output ~/.openclaw/workspace/ \
--all-agents --shared --bundle --force
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |