https://github.com/getclawe/clawe
Multi-agent coordination system: think Trello for OpenClaw agents.
https://github.com/getclawe/clawe
ai-agents ai-assistant claude-code clawbot openclaw
Last synced: about 2 months ago
JSON representation
Multi-agent coordination system: think Trello for OpenClaw agents.
- Host: GitHub
- URL: https://github.com/getclawe/clawe
- Owner: getclawe
- License: agpl-3.0
- Created: 2026-02-02T14:35:09.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-02-18T14:53:30.000Z (4 months ago)
- Last Synced: 2026-02-18T14:57:14.517Z (4 months ago)
- Topics: ai-agents, ai-assistant, claude-code, clawbot, openclaw
- Language: TypeScript
- Homepage: https://clawe.ai
- Size: 23.7 MB
- Stars: 354
- Watchers: 1
- Forks: 35
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Cla: CLA.md
Awesome Lists containing this project
- awesome-agent-orchestrators - clawe - Multi-agent coordination system: think Trello for OpenClaw agents. (Multi-Agent Swarms)
- awesome-openclaw-dashboards - getclawe/clawe - Multi-agent coordination system for OpenClaw agents. (Orchestration & Workflows)
- awesome-openclaw - getclawe/clawe - Trello-style multi-agent coordination system built around OpenClaw workflows. (🎛️ Dashboards & Control Centers)
README
A multi-agent coordination system powered by OpenClaw.
Deploy a team of AI agents that work together, each with their own identity, workspace, and scheduled heartbeats. Coordinate tasks, share context, and deliver notifications in near real-time.
## Features
- Run multiple AI agents with distinct roles and personalities
- Agents wake on cron schedules to check for work
- Kanban-style task management with assignments and subtasks
- Instant delivery of @mentions and task updates
- Agents collaborate through shared files and Convex backend
- Monitor squad status, tasks, and chat with agents from a web dashboard
## Quick Start
### Prerequisites
- Docker & Docker Compose
- [Convex](https://convex.dev) account (free tier works)
- Anthropic API key
### 1. Clone and Setup
```bash
git clone https://github.com/getclawe/clawe.git
cd clawe
cp .env.example .env
```
### 2. Configure Environment
Edit `.env`:
```bash
# Required
SQUADHUB_TOKEN=your-secure-token
CONVEX_URL=https://your-deployment.convex.cloud
# API keys (Anthropic, OpenAI) are configured via the UI during onboarding
```
### 3. Deploy Convex Backend
```bash
pnpm install
cd packages/backend
npx convex deploy
```
### 4. Start the System
**Production (recommended):**
```bash
./scripts/start.sh
```
This script will:
- Create `.env` from `.env.example` if missing
- Auto-generate a secure `SQUADHUB_TOKEN`
- Validate all required environment variables
- Build necessary packages
- Start the Docker containers
**Development:**
```bash
# Start squadhub gateway only (use local web dev server)
pnpm dev:docker
# In another terminal, start web + Convex
pnpm dev
```
The production stack starts:
- **squadhub**: Gateway running all agents
- **watcher**: Notification delivery + cron setup
- **clawe**: Web dashboard at http://localhost:3000
## The Squad
Clawe comes with 4 pre-configured agents:
| Agent | Role | Heartbeat |
| -------- | -------------- | ------------ |
| 🦞 Clawe | Squad Lead | Every 15 min |
| ✍️ Inky | Content Editor | Every 15 min |
| 🎨 Pixel | Designer | Every 15 min |
| 🔍 Scout | SEO | Every 15 min |
Heartbeats are staggered to avoid rate limits.
## Routines
Schedule recurring tasks that automatically create inbox items:
- Configure day/time schedules per routine
- 1-hour trigger window for crash tolerance
- Tasks created with Clawe as the creator
- Manage via Settings → General in the dashboard
## Architecture
```
┌─────────────────────────────────────────────────────────────┐
│ DOCKER COMPOSE │
├─────────────────┬─────────────────────┬─────────────────────┤
│ squadhub │ watcher │ clawe │
│ │ │ │
│ Agent Gateway │ • Register agents │ Web Dashboard │
│ with 4 agents │ • Setup crons │ • Squad status │
│ │ • Deliver notifs │ • Task board │
│ │ │ • Agent chat │
└────────┬────────┴──────────┬──────────┴──────────┬──────────┘
│ │ │
└───────────────────┼─────────────────────┘
│
┌────────▼────────┐
│ CONVEX │
│ (Backend) │
│ │
│ • Agents │
│ • Tasks │
│ • Notifications│
│ • Activities │
└─────────────────┘
```
## Project Structure
```
clawe/
├── apps/
│ ├── web/ # Next.js dashboard
│ └── watcher/ # Notification watcher service
├── packages/
│ ├── backend/ # Convex schema & functions
│ ├── cli/ # `clawe` CLI for agents
│ ├── shared/ # Shared squadhub client
│ └── ui/ # UI components
└── docker/
└── squadhub/
├── Dockerfile
├── entrypoint.sh
├── scripts/ # init-agents.sh
└── templates/ # Agent workspace templates
```
## CLI Commands
Agents use the `clawe` CLI to interact with the coordination system:
```bash
# Check for notifications
clawe check
# List tasks
clawe tasks
clawe tasks --status in_progress
# View task details
clawe task:view
# Update task status
clawe task:status in_progress
clawe task:status review
# Add comments
clawe task:comment "Working on this now"
# Manage subtasks
clawe subtask:add "Research competitors"
clawe subtask:check 0
# Register deliverables
clawe deliver "Final Report" --path ./report.md
# Send notifications
clawe notify "Need your review on this"
# View squad status
clawe squad
# Activity feed
clawe feed
```
## Agent Workspaces
Each agent has an isolated workspace with:
```
/data/workspace-{agent}/
├── AGENTS.md # Instructions and conventions
├── SOUL.md # Agent identity and personality
├── USER.md # Info about the human they serve
├── HEARTBEAT.md # What to do on each wake
├── MEMORY.md # Long-term memory
├── TOOLS.md # Local tool notes
└── shared/ # Symlink to shared state
├── WORKING.md # Current team status
└── WORKFLOW.md # Standard operating procedures
```
## Customization
### Adding New Agents
1. Create workspace template in `docker/squadhub/templates/workspaces/{name}/`
2. Add agent to `docker/squadhub/templates/config.template.json`
3. Add agent to watcher's `AGENTS` array in `apps/watcher/src/index.ts`
4. Rebuild: `docker compose build && docker compose up -d`
### Changing Heartbeat Schedules
Edit the `AGENTS` array in `apps/watcher/src/index.ts`:
```typescript
const AGENTS = [
{
id: "main",
name: "Clawe",
emoji: "🦞",
role: "Squad Lead",
cron: "0 * * * *",
},
// Add or modify agents here
];
```
## Development
```bash
# Install dependencies
pnpm install
# Terminal 1: Start Convex dev server
pnpm convex:dev
# Terminal 2: Start squadhub gateway in Docker
pnpm dev:docker
# Terminal 3: Start web dashboard
pnpm dev:web
# Or run everything together (Convex + web, but not squadhub)
pnpm dev
```
### Useful Commands
```bash
# Build everything
pnpm build
# Type check
pnpm check-types
# Lint and format
pnpm check # Check only
pnpm fix # Auto-fix
# Deploy Convex to production
pnpm convex:deploy
```
## Environment Variables
| Variable | Required | Description |
| ---------------- | -------- | ------------------------------- |
| `SQUADHUB_TOKEN` | Yes | Auth token for squadhub gateway |
| `CONVEX_URL` | Yes | Convex deployment URL |
API keys (Anthropic, OpenAI) are managed via the UI during onboarding and in Settings > General > API Keys.
