OpenClaw Squad 🎯

A 7-agent AI team built on OpenClaw — specialized agents that collaborate via Discord to handle real-world tasks.

Meet the Team

Agent	Role	Specialty
🎯 Leader	Squad Lead	Day-to-day coordination, primary human interface
🔀 Orchestrator	Orchestrator	Complex multi-step tasks, delegation
🛠️ Builder	Builder	Coding, development, technical implementation
📚 Scholar	Scholar	Research, analysis, knowledge synthesis
🛡️ Sentinel	Sentinel	Monitoring, alerts, security
🔧 Fixer	Fixer	Creative problem-solving, hacks, workarounds
⚠️ Operator	Operator	High-risk operations, edge cases

What They Can Do

• 📧 Email — Read, search, and send via Gmail and iCloud
• 📞 Phone calls — Outbound calls via ElevenLabs + Twilio
• 📅 Calendar — Check and manage Google Calendar + iCloud
• 💻 Code — Build features, fix bugs, deploy
• 🔍 Research — Web search, summarization, analysis
• 📊 Monitoring — Watch for events, alert on conditions
• 💬 Messaging — Discord, WhatsApp, Telegram coordination
• 🖼️ Image generation — Memes and graphics via Gemini

Architecture

┌─────────────────────────────────────────────────────────┐
│                     Discord Server                       │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐       │
│  │ #general│ │ #builder│ │#agent-  │ │ #alerts │       │
│  │         │ │         │ │ comms   │ │         │       │
│  └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘       │
└───────┼──────────┼──────────┼──────────┼───────────────┘
        │          │          │          │
        ▼          ▼          ▼          ▼
┌─────────────────────────────────────────────────────────┐
│                   OpenClaw Gateway                       │
│  ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │
│  │ Leader │ │Orchestrator │ │ Builder │ │ Scholar │ │ Sentinel │ │ Fixer │ │
│  └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ │
└─────────────────────────────────────────────────────────┘
        │
        ▼
┌─────────────────────────────────────────────────────────┐
│                    External Services                     │
│  Gmail │ iCloud │ Twilio │ ElevenLabs │ GitHub │ etc   │
└─────────────────────────────────────────────────────────┘

Setup

Prerequisites

• Node.js 20+
• OpenClaw installed (npm install -g openclaw)
• Discord bot tokens (one per agent)
• API keys for services you want to use

1. Install OpenClaw

npm install -g openclaw
openclaw init

2. Configure Agents

Each agent needs:

• A Discord bot token
• A SOUL.md defining personality
• Optional: dedicated workspace

See agents/ for example configurations.

3. Configure Services

Copy the example configs and add your API keys:

cp config/example.yaml config/openclaw.yaml
# Edit with your keys

4. Start the Gateway

openclaw gateway start

Configuration

Discord Setup

1. Create a Discord server
2. Create a bot application for each agent at discord.com/developers
3. Enable Message Content Intent for each bot
4. Invite all bots to your server
5. Configure channels in openclaw.yaml

Agent Personalities (SOUL.md)

Each agent has a SOUL.md that defines:

• Name and role
• Personality traits
• Communication style
• Boundaries and capabilities

See agents/ for examples.

Services

Service	Purpose	Config Location
Gmail	Email read/send	~/.config/gogcli/
iCloud	Calendar, email	~/.config/icloud/config.json
ElevenLabs	TTS, phone calls	~/.config/elevenlabs/config.json
Twilio	Phone number	~/.config/twilio/config.json
GitHub	Code, issues	gh auth login

File Structure

~/.openclaw/
├── config.yaml          # Main OpenClaw config
├── agents/
│   ├── main/           # Leader (primary agent)
│   │   └── agent/
│   │       └── SOUL.md
│   ├── proxy/          # Orchestrator agent
│   ├── tech/           # Builder agent
│   ├── yoda/           # Scholar agent
│   ├── boba/           # Sentinel agent
│   ├── babu/           # Fixer agent
│   └── maul/           # Operator agent
└── workspace/          # Shared workspace
    ├── AGENTS.md       # Agent instructions
    ├── SOUL.md         # Primary personality
    ├── USER.md         # User context
    ├── TOOLS.md        # Local tool notes
    ├── MEMORY.md       # Long-term memory
    ├── HEARTBEAT.md    # Periodic task config
    └── memory/         # Daily memory files

Heartbeats & Cron

Agents can run periodic tasks:

• Heartbeats — Regular check-ins (every 30 min) for batched tasks
• Cron jobs — Scheduled tasks with precise timing

Example heartbeat config (HEARTBEAT.md):

## Email Check
Check Gmail for important unread messages

## Calendar Check  
Look for upcoming events in the next 24 hours

Inter-Agent Communication

Agents communicate via:

1. Discord channels — Public coordination in shared channels
2. Sessions — Direct agent-to-agent messaging
3. Spawning — Creating sub-agents for complex tasks

Security Notes

• 🔒 Never commit API keys or tokens
• 🔒 Use environment variables or secure config files
• 🔒 Review agent permissions carefully
• 🔒 Agents have read access to your data — trust accordingly

Links

• OpenClaw Documentation
• OpenClaw GitHub
• OpenClaw Discord
• ClawHub Skills

License

MIT — do whatever you want with this.

---

Built by @jhammant