GitHub - getclawe/clawe: Multi-agent coordination system powered by OpenClaw. Good for automating weekly SEO review, editing, and publishing workflows for agencies

🦞 Clawe

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 account (free tier works)
Anthropic API key

1. Clone and Setup

git clone https://github.com/getclawe/clawe.git cd clawe cp .env.example .env

2. Configure Environment

Edit .env:

Required

ANTHROPIC_API_KEY=sk-ant-... OPENCLAW_TOKEN=your-secure-token CONVEX_URL=https://your-deployment.convex.cloud

Optional

OPENAI_API_KEY=sk-... # For image generation

3. Deploy Convex Backend

pnpm install cd packages/backend npx convex deploy

4. Start the System

Production (recommended):

./scripts/start.sh

This script will:

Create .env from .env.example if missing
Auto-generate a secure OPENCLAW_TOKEN
Validate all required environment variables
Build necessary packages
Start the Docker containers

Development:

Start OpenClaw gateway only (use local web dev server)

pnpm dev:docker

In another terminal, start web + Convex

pnpm dev

The production stack starts:

openclaw: 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                          │
├─────────────────┬─────────────────────┬─────────────────────┤
│    openclaw     │       watcher       │        clawe        │
│                 │                     │                     │
│  OpenClaw       │  • Register agents  │  Web Dashboard      │
│  Gateway with   │  • Setup crons      │  • Squad status     │
│  4 agents       │  • 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 OpenClaw client
│   └── ui/               # UI components
└── docker/
    └── openclaw/
        ├── Dockerfile
        ├── entrypoint.sh
        ├── scripts/      # init-agents.sh
        └── templates/    # Agent workspace templates

CLI Commands

Agents use the clawe CLI to interact with the coordination system:

Check for notifications

clawe check

List tasks

clawe tasks clawe tasks --status in_progress

View task details

clawe task:view <task-id>

Update task status

clawe task:status <task-id> in_progress clawe task:status <task-id> review

Add comments

clawe task:comment <task-id> "Working on this now"

Manage subtasks

clawe subtask:add <task-id> "Research competitors" clawe subtask:check <task-id> 0

Register deliverables

clawe deliver <task-id> "Final Report" --path ./report.md

Send notifications

clawe notify <session-key> "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

Create workspace template in docker/openclaw/templates/workspaces/{name}/
Add agent to docker/openclaw/templates/config.template.json
Add agent to watcher's AGENTS array in apps/watcher/src/index.ts
Rebuild: docker compose build && docker compose up -d

Changing Heartbeat Schedules

Edit the AGENTS array in apps/watcher/src/index.ts:

const AGENTS = [ { id: "main", name: "Clawe", emoji: "🦞", role: "Squad Lead", cron: "0 * * * *", }, // Add or modify agents here ];

Development

Install dependencies

pnpm install

Terminal 1: Start Convex dev server

pnpm convex:dev

Terminal 2: Start OpenClaw gateway in Docker