A powerful management tool for spawning, monitoring, and steering specialized sub-intelligent entities to handle complex workflows.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install create-subagent
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install create-subagent using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is SubAgent Creator?
The SubAgent Creator is a specialized tool designed to extend the capabilities of your primary AI agent by delegating complex tasks to dedicated sub-entities. By utilizing this component of Openclaw Skills, developers can spawn multiple agents with specific system prompts, toolsets, and lifecycle behaviors. This allows for a modular approach to problem-solving where specialized agents handle development, research, writing, or data analysis in parallel.
This skill provides the administrative layer needed to maintain a multi-agent environment. It handles everything from the initial spawning process using templates to real-time steering and logging. By integrating these Openclaw Skills into your workflow, you can move beyond single-threaded task execution and build a collaborative team of AI agents that work autonomously toward a common goal.
SubAgent Creator Use Cases
- Creating a dedicated Development Assistant for full-stack coding tasks using specialized tools.
- Spawning a Research SubAgent to perform web searches and information synthesis independently.
- Managing multiple concurrent tasks by running up to 8 agents in parallel.
- Steering the direction of an active agent when task requirements change mid-execution.
- Cleaning up resources by terminating or archiving agents that have completed their objectives.
How SubAgent Creator Works
- Requirement Definition: The user specifies the agent role (e.g., dev, research, or custom) and the primary responsibilities.
- Mode Configuration: The skill determines if the agent should run as a one-off task (run mode) or a persistent session (session mode).
- Session Spawning: The sessions_spawn command is triggered with a defined task prompt, label, and cleanup policy.
- Interaction & Monitoring: The user interacts with the new agent using unique IDs or labels to send messages or view execution logs.
- Lifecycle Completion: The agent either self-terminates upon task completion or is manually killed, with automatic archiving occurring after 60 minutes of inactivity.
SubAgent Creator Setup
To enable sub-agent spawning, you must configure your Openclaw Gateway settings. Update your openclaw-config.json to define permitted agents and concurrency limits.
{
"agents": {
"list": [
{
"id": "main",
"subagents": { "allowAgents": ["main", "developer"] }
}
],
"defaults": {
"subagents": {
"maxConcurrent": 8,
"maxSpawnDepth": 2
}
}
}
}
After updating the configuration, restart your gateway to apply the changes for your Openclaw Skills setup.
SubAgent Creator Data Schema & Taxonomy
The skill organizes sub-agents using a structured metadata taxonomy to ensure trackability and resource management.
| Property | Type | Description |
|---|---|---|
| label | String | A concise identifier for the agent instance (e.g., dev-agent) |
| task | String | The system instructions and role definition for the SubAgent |
| mode | String | Execution strategy: 'run' for tasks or 'session' for threads |
| cleanup | String | Retention policy for the agent session (default: 'keep') |
| run_id | Integer | The unique numerical identifier assigned during spawning |
SubAgent Creator Advanced Features
- Concurrent Execution: Support for up to 8 active SubAgents running different specialized tasks simultaneously.
- Dynamic Steering: Use the steer command to provide mid-task course corrections without needing to restart the agent.
- Template Library: Pre-configured templates for common roles including dev-agent, research-agent, and data-agent.
- Real-time Log Streaming: Ability to monitor the internal thought process and tool usage of any sub-agent via the log command.
- Thread Binding: Support for session-based interactions in channels that allow for persistent thread connectivity.
SKILL.md
Loading
Related Openclaw Skills
Security Scanner
A security-focused tool that audits Openclaw Skills for vulnerabilities, suspicious API calls, and malicious patterns prior to installation.
Task Review Workflow
A standardized, high-integrity PR review and merge process designed for task-driven AI agent collaboration.
Task Development Workflow
A structured, quality-first development lifecycle for AI agents involving rigorous planning, test-driven development, and pull request reviews.
Feishu Voice Skill
Empowers AI agents to send authentic, playable voice messages directly to Feishu users instead of standard file attachments.
Create SubAgent
A powerful orchestration skill to spawn and manage specialized subordinate agents for parallel task execution.
Academic Research Hub
A comprehensive scholarly research integration for searching databases, downloading PDFs, and automating citation management.
Featured*
