agent-squad

name	agent-squad
description	Create and manage teams of specialized AI agents that work together on tasks. Use when setting up multi-agent workflows, agent squads for content/marketing/research pipelines, configuring heartbeat-based agent coordination, or managing agent personalities via SOUL.md files. Enables orchestration of multiple OpenClaw sessions as a coordinated team with shared task systems (Linear, Trello, etc.).

Agent Squad

Orchestrate teams of specialized AI agents that collaborate on tasks via shared workspaces and heartbeat scheduling.

Quick Start

# Initialize your squad
agent-squad init my-squad

# Add agents
agent-squad add researcher --role "Deep researcher. Finds sources and data."
agent-squad add writer --role "Content writer. Sharp, opinionated voice."
agent-squad add lead --role "Squad lead. Coordinates and reports."

# Configure task system
agent-squad config --tasks linear --project "Content Squad"

# Start heartbeats (agents wake every 15 min)
agent-squad start

What This Enables

Before: One AI doing everything. Context bloat. Generic output.

After: Specialized agents with distinct roles, shared task board, coordinated via heartbeats. Each agent:

• Has a unique personality (SOUL.md)
• Checks for work every 15 minutes (cron)
• Posts updates to shared task system
• @mentions other agents when handoffs needed

Core Concepts

Agents = OpenClaw Sessions

Each agent is an isolated OpenClaw session with:

• Unique session key (agent:{name}:main)
• Custom (personality, role, tools)