Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Create and manage multi-agent teams in OpenClaw with shared workspace, budget governance, and mesh networking. Use when: (1) adding a new agent to an existin...
Create and manage multi-agent teams in OpenClaw with shared workspace, budget governance, and mesh networking. Use when: (1) adding a new agent to an existin...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Create and manage multi-agent teams with shared memory, budget governance, and configurable spawn permissions.
Main Workspace (~/.openclaw/workspace/) โโโ MEMORY.md, TOOLS.md, USER.md, IDENTITY.md โ shared brain (real files) โโโ agents/<name>/ โ per-agent outbox, inbox, budget โโโ agents/governance/ โ governance rules + audit log โโโ memory/, projects/, scripts/, skills/ โ shared resources โโโ content/ โ shared content Agent Workspace (~/.openclaw/workspace-<id>/) โโโ SOUL.md โ unique personality (local file) โโโ AGENTS.md โ unique instructions (local file) โโโ HEARTBEAT.md โ agent-specific heartbeat (local file) โโโ .openclaw/ โ agent-specific config dir โโโ everything else โ SYMLINKS to main workspace
AGENT_ID="<id>" MAIN="$HOME/.openclaw/workspace" WS="$HOME/.openclaw/workspace-$AGENT_ID" mkdir -p "$WS/.openclaw" # Symlink shared brain for f in .learnings IDENTITY.md MEMORY.md ROADMAP.md TOOLS.md USER.md; do ln -sf "../workspace/$f" "$WS/$f" done for d in agents content memory projects scripts skills; do ln -sf "../workspace/$d" "$WS/$d" done
Create $WS/SOUL.md โ the agent's personality. This is theirs alone. Create $WS/AGENTS.md โ agent-specific instructions. Must include: Session startup checklist (read SOUL.md, check BUDGET.json, check INBOX.md) Communication rules (INBOX/OUTBOX pattern) What the agent does and doesn't do Budget rules section (see references/budget-rules.md) Create $WS/HEARTBEAT.md โ minimal heartbeat config.
mkdir -p "$MAIN/agents/$AGENT_ID" touch "$MAIN/agents/$AGENT_ID/INBOX.md" touch "$MAIN/agents/$AGENT_ID/OUTBOX.md"
Copy scripts/create_budget.sh output or create manually: { "daily_limit_output_tokens": 50000, "today": "YYYY-MM-DD", "used_output_tokens": 0, "spawns": [], "status": "active", "warnings": [], "consecutive_overbudget_days": 0 } Save to $MAIN/agents/$AGENT_ID/BUDGET.json.
Add to agents.list[]: { "id": "<id>", "name": "<Name>", "workspace": "/absolute/path/to/workspace-<id>", "identity": { "name": "<Name>", "emoji": "<emoji>" }, "model": { "primary": "anthropic/claude-sonnet-4-6", "fallbacks": ["<fallback-model-1>", "<fallback-model-2>"] }, "subagents": { "allowAgents": ["<peer1>", "<peer2>"] } } Update existing agents' allowAgents to include the new agent.
python3 -c "import json; json.load(open('$HOME/.openclaw/openclaw.json')); print('JSON valid')" openclaw doctor # check for schema errors launchctl stop ai.openclaw.gateway && sleep 2 && launchctl start ai.openclaw.gateway Wait 15 seconds before testing.
Only the orchestrator (main) can spawn agents. Agents route requests through OUTBOX. "subagents": { "allowAgents": [] } // for all non-main agents
All agents can spawn peers. Budget governance prevents abuse. // Each agent can spawn all peers (not themselves) "subagents": { "allowAgents": ["<all other agent ids>"] }
Start hub-and-spoke. Promote to mesh after demonstrating budget responsibility. Demote back to hub-and-spoke after repeated overspend.
See references/governance.md for the full framework. Run the audit script on heartbeat: python3 scripts/budget_audit.py Thresholds: Green (<80%), Yellow (80-100%), Red (>100%), Emergency demotion (>200%). 3 consecutive overbudget days โ automatic demotion (mesh privileges revoked). Add step 4.5 to your HEARTBEAT.md โ see references/heartbeat-snippet.md.
For project work, compose agent committees: Identify which agents are needed (e.g., content + marketing + design review) Spawn them in parallel with clear, scoped tasks Each writes to their OUTBOX.md Orchestrator collects results and synthesizes Budget tracked per-agent across the project
After adding an agent, verify: workspace-<id>/ has SOUL.md + AGENTS.md as local files All other files are symlinks to main workspace agents/<id>/BUDGET.json exists with correct schema Agent appears in openclaw doctor output Gateway restarts without errors Agent can be spawned: sessions_spawn(agentId="<id>", task="Say hello") Budget audit includes the new agent: python3 scripts/budget_audit.py
Workflow acceleration for inboxes, docs, calendars, planning, and execution loops.
Largest current source with strong distribution and engagement signals.