Mansion

What This Skill Does

The Mansion skill is an architectural framework for OpenClaw that organizes autonomous agents into a hierarchical, role-based ecosystem known as the 'Zoro Agent Architecture.' By treating an AI workflow like a functional household, this skill ensures that tasks are delegated efficiently through specific specialized roles: the Master (Zorro), the Factory Manager, the Butler, the Librarian, the Janitor, and the Moderator. Instead of a single agent attempting to do everything, the Mansion enforces a structured communication and execution protocol. It handles API key management, task delegation, team spawning, and cleanup operations, ensuring that the system remains organized and performant even under complex multi-agent workloads.

Installation

To install this skill, use the OpenClaw terminal and enter the following command: clawhub install openclaw/skills/skills/sarthib7/mansion Ensure that you have your primary API key configured for the Zorro master agent before initializing the mansion, as all sub-agents will rely on the Butler to distribute secondary keys correctly.

Use Cases

• Complex Project Orchestration: Break down massive development or research projects into manageable sub-tasks handled by specialized agents.
• API Key Governance: Automatically rotate and manage multiple secondary API keys across a team of agents to avoid rate limits and cost spikes.
• Cleanup and Maintenance: Automated post-task garbage collection to free up memory and persistent state after a job is completed.
• Team Collaboration: Managing temporary sub-teams for specific sprints or research phases without overloading the primary master agent.

Example Prompts

1. "Mansion, initialize the Factory Manager. We have a new project to scrape financial data and generate a report; coordinate with the Librarian to identify required skills."
2. "Butler, check our current secondary API key usage and perform a rotation if we are approaching the 80% limit."
3. "Moderator, the data scraping task is finished. Please summon the Janitor to clear the temporary files and finalize the workspace."

Tips & Limitations

• Adhere to the hierarchy: Never ask Zorro to create a team directly; always route requests through the Factory Manager to maintain system integrity.
• Monitor the Janitor: Always allow the Janitor to perform its cleanup duties only after completion to prevent data loss.
• Rotation discipline: The 80% rule for API key rotation is critical to avoid hard shutdowns; ensure your Butler configuration is tuned to this threshold.
• This skill is best suited for advanced users managing complex, long-running AI workflows who need structural stability over simple task execution.