🦞

ClawCrew

A framework for building collaborative AI agent teams on OpenClaw

GitHub OpenClaw Docs

What is ClawCrew?

ClawCrew is a framework for creating multi-agent teams that collaborate on tasks. Instead of one AI doing everything, you define specialized agents with focused roles, and an orchestrator coordinates their work.

🧬

Each Agent Evolves

Train and tune each agent's capabilities separately — refine the designer's taste, sharpen the coder's style, improve the tester's coverage.

👔

You're the Manager

In Telegram, talk to the orchestrator and watch every agent work in real-time. Jump in anytime — give feedback, correct course, or let them run.

✨

Workspace = Capability

Each agent's capabilities are defined by its workspace — SOUL.md, skills, and tools. Change the workspace, change the agent.

Core Concept

┌──────────────────────────────────────────────────────────────┐ │ ClawCrew Framework │ ├──────────────────────────────────────────────────────────────┤ │ │ │ Orchestrator Agent (workspace_orca/) │ │ ├── SOUL.md → Personality & rules │ │ ├── AGENTS.md → Behavior guidelines │ │ └── skills/ → Available capabilities │ │ │ │ │ spawns │ │ ▼ │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ │ Agent A │ │ Agent B │ │ Agent C │ │ │ │ workspace_A/ │ │ workspace_B/ │ │ workspace_C/ │ │ │ └──────────────┘ └──────────────┘ └──────────────┘ │ │ │ │ Each agent = unique workspace = unique capabilities │ │ │ └──────────────────────────────────────────────────────────────┘

Example Teams

💻 Software Dev Team

🦑 OrcaBot (Orchestrator) ├── 🎨 DesignBot → API design, specs ├── 💻 CodeBot → Implementation └── 🧪 TestBot → Testing, coverage

Automated code generation with quality gates

📚 Research Team

📚 ResearchLead (Orchestrator) ├── 🔍 SearchBot → Web research ├── 📊 AnalystBot → Data analysis └── ✍️ WriterBot → Report writing

Deep research with structured output

🎬 Content Team

🎬 ContentLead (Orchestrator) ├── 💡 IdeaBot → Brainstorming ├── ✏️ DraftBot → Writing drafts └── 🔍 EditorBot → Review, polish

Blog posts, marketing copy, documentation

🎯 Support Team

🎯 SupportLead (Orchestrator) ├── 🔍 TriageBot → Categorize issues ├── 💬 ReplyBot → Draft responses └── 📈 EscalateBot → Complex handling

Automated support ticket handling

Software Dev Team

The included example shows a complete software development crew with design, implementation, and testing phases.

Agent Role Deliverables
🦑 OrcaBot Orchestrator Task breakdown, quality gates, final delivery
🎨 DesignBot Architect API specs, types, edge cases
💻 CodeBot Engineer Implementation, docstrings
🧪 TestBot QA Unit tests, coverage report
1

Design Phase

OrcaBot spawns DesignBot → API spec created → OrcaBot reviews ✅

2

Code Phase

OrcaBot spawns CodeBot → Module implemented → OrcaBot reviews ✅

3

Test Phase

OrcaBot spawns TestBot → Tests written & run → OrcaBot reviews ✅

4

Final Delivery 🚀

Code + Tests + Documentation delivered with full coverage

Getting Started

Prerequisites: OpenClaw installed and configured. See OpenClaw docs.

1 Create Telegram Bot

Message @BotFather → /newbot → Get token

Important: Disable privacy mode so the bot sees all group messages.

2 Create Telegram Group

Create a group, add your bot, and get the chat_id.

3 Clone & Setup

git clone https://github.com/anthropics/clawcrew cd clawcrew ./setup.sh

4 Start & Test

openclaw gateway restart

Send a message in your Telegram group:

Create a Python module to calculate distance between two points

Roadmap

✅

Current

Multi-agent orchestration, Software Dev Team example, Quality gates, Real-time chat visibility

🔄

Framework Core

Easy onboarding, Role templates, Hot reload, Shared context, Team memory

🔮

Future

GitHub integration, PR workflows, Multi-file projects, CI/CD hooks