by getclawe
Multi-agent coordination system: think Trello for OpenClaw agents.
# Add to your Claude Code skills
git clone https://github.com/getclawe/claweLast scanned: 5/7/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-07T06:37:50.135Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": true
}No comments yet. Be the first to share your thoughts!
git clone https://github.com/getclawe/clawe.git
cd clawe
cp .env.example .env
Edit .env:
# Required
SQUADHUB_TOKEN=your-secure-token
CONVEX_URL=https://your-deployment.convex.cloud
# API keys (Anthropic, OpenAI) are configured via the UI during onboarding
pnpm install
cd packages/backend
npx convex deploy
Production (recommended):
./scripts/start.sh
This script will:
.env from .env.example if missingSQUADHUB_TOKENDevelopment:
# Start squadhub gateway only (use local web dev server)
pnpm dev:docker
# In another terminal, start web + Convex
pnpm dev
The production stack starts:
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.
Schedule recurring tasks that automatically create inbox items:
┌─────────────────────────────────────────────────────────────┐
│ 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 │
└─────────────────┘
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
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
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
docker/squadhub/templates/workspaces/{name}/docker/squadhub/templates/config.template.jsonAGENTS array in apps/watcher/src/index.tsdocker compose build && docker compose up -dEdit 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
];
# 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
# 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
| 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.