{"id":48565408,"url":"https://github.com/getclawe/clawe","last_synced_at":"2026-04-24T05:00:29.224Z","repository":{"id":337713728,"uuid":"1148062975","full_name":"getclawe/clawe","owner":"getclawe","description":"Multi-agent coordination system: think Trello for OpenClaw agents. ","archived":false,"fork":false,"pushed_at":"2026-02-18T14:53:30.000Z","size":24892,"stargazers_count":354,"open_issues_count":2,"forks_count":35,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-18T14:57:14.517Z","etag":null,"topics":["ai-agents","ai-assistant","claude-code","clawbot","openclaw"],"latest_commit_sha":null,"homepage":"https://clawe.ai","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/getclawe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":"CLA.md"}},"created_at":"2026-02-02T14:35:09.000Z","updated_at":"2026-02-18T14:49:36.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/getclawe/clawe","commit_stats":null,"previous_names":["getclawe/clawe"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/getclawe/clawe","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getclawe%2Fclawe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getclawe%2Fclawe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getclawe%2Fclawe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getclawe%2Fclawe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/getclawe","download_url":"https://codeload.github.com/getclawe/clawe/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getclawe%2Fclawe/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32209895,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T03:15:14.334Z","status":"ssl_error","status_checked_at":"2026-04-24T03:15:11.608Z","response_time":64,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","ai-assistant","claude-code","clawbot","openclaw"],"created_at":"2026-04-08T13:00:22.271Z","updated_at":"2026-04-24T05:00:29.212Z","avatar_url":"https://github.com/getclawe.png","language":"TypeScript","funding_links":[],"categories":["Multi-Agent Swarms","Orchestration \u0026 Workflows","🎛️ Dashboards \u0026 Control Centers"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./docs/images/clawe-logo.png\" alt=\"Clawe\" width=\"600\" /\u003e\n  \u003cp\u003e\u003cstrong\u003eA multi-agent coordination system powered by \u003ca href=\"https://github.com/openclaw/openclaw\"\u003eOpenClaw\u003c/a\u003e.\u003c/strong\u003e\u003c/p\u003e\n  \u003cp\u003eDeploy 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.\u003c/p\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cvideo src=\"https://github.com/user-attachments/assets/d2f892d9-4c32-4c31-95e5-222d4ea87592\" width=\"600\" controls\u003e\n    \u003ca href=\"https://www.clawe.ai/assets/clawe-demo.mp4\"\u003e\n      \u003cimg src=\"./docs/images/board.png\" alt=\"Clawe\" width=\"600\" /\u003e\n      \u003cbr\u003e▶ Watch demo\n    \u003c/a\u003e\n  \u003c/video\u003e\n\u003c/div\u003e\n\n## Features\n\n- Run multiple AI agents with distinct roles and personalities\n- Agents wake on cron schedules to check for work\n- Kanban-style task management with assignments and subtasks\n- Instant delivery of @mentions and task updates\n- Agents collaborate through shared files and Convex backend\n- Monitor squad status, tasks, and chat with agents from a web dashboard\n\n## Quick Start\n\n### Prerequisites\n\n- Docker \u0026 Docker Compose\n- [Convex](https://convex.dev) account (free tier works)\n- Anthropic API key\n\n### 1. Clone and Setup\n\n```bash\ngit clone https://github.com/getclawe/clawe.git\ncd clawe\ncp .env.example .env\n```\n\n### 2. Configure Environment\n\nEdit `.env`:\n\n```bash\n# Required\nSQUADHUB_TOKEN=your-secure-token\nCONVEX_URL=https://your-deployment.convex.cloud\n\n# API keys (Anthropic, OpenAI) are configured via the UI during onboarding\n```\n\n### 3. Deploy Convex Backend\n\n```bash\npnpm install\ncd packages/backend\nnpx convex deploy\n```\n\n### 4. Start the System\n\n**Production (recommended):**\n\n```bash\n./scripts/start.sh\n```\n\nThis script will:\n\n- Create `.env` from `.env.example` if missing\n- Auto-generate a secure `SQUADHUB_TOKEN`\n- Validate all required environment variables\n- Build necessary packages\n- Start the Docker containers\n\n**Development:**\n\n```bash\n# Start squadhub gateway only (use local web dev server)\npnpm dev:docker\n\n# In another terminal, start web + Convex\npnpm dev\n```\n\nThe production stack starts:\n\n- **squadhub**: Gateway running all agents\n- **watcher**: Notification delivery + cron setup\n- **clawe**: Web dashboard at http://localhost:3000\n\n## The Squad\n\nClawe comes with 4 pre-configured agents:\n\n| Agent    | Role           | Heartbeat    |\n| -------- | -------------- | ------------ |\n| 🦞 Clawe | Squad Lead     | Every 15 min |\n| ✍️ Inky  | Content Editor | Every 15 min |\n| 🎨 Pixel | Designer       | Every 15 min |\n| 🔍 Scout | SEO            | Every 15 min |\n\nHeartbeats are staggered to avoid rate limits.\n\n## Routines\n\nSchedule recurring tasks that automatically create inbox items:\n\n- Configure day/time schedules per routine\n- 1-hour trigger window for crash tolerance\n- Tasks created with Clawe as the creator\n- Manage via Settings → General in the dashboard\n\n## Architecture\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│                     DOCKER COMPOSE                          │\n├─────────────────┬─────────────────────┬─────────────────────┤\n│    squadhub     │       watcher       │        clawe        │\n│                 │                     │                     │\n│  Agent Gateway  │  • Register agents  │  Web Dashboard      │\n│  with 4 agents  │  • Setup crons      │  • Squad status     │\n│                 │  • Deliver notifs   │  • Task board       │\n│                 │                     │  • Agent chat       │\n└────────┬────────┴──────────┬──────────┴──────────┬──────────┘\n         │                   │                     │\n         └───────────────────┼─────────────────────┘\n                             │\n                    ┌────────▼────────┐\n                    │     CONVEX      │\n                    │   (Backend)     │\n                    │                 │\n                    │  • Agents       │\n                    │  • Tasks        │\n                    │  • Notifications│\n                    │  • Activities   │\n                    └─────────────────┘\n```\n\n## Project Structure\n\n```\nclawe/\n├── apps/\n│   ├── web/              # Next.js dashboard\n│   └── watcher/          # Notification watcher service\n├── packages/\n│   ├── backend/          # Convex schema \u0026 functions\n│   ├── cli/              # `clawe` CLI for agents\n│   ├── shared/           # Shared squadhub client\n│   └── ui/               # UI components\n└── docker/\n    └── squadhub/\n        ├── Dockerfile\n        ├── entrypoint.sh\n        ├── scripts/      # init-agents.sh\n        └── templates/    # Agent workspace templates\n```\n\n## CLI Commands\n\nAgents use the `clawe` CLI to interact with the coordination system:\n\n```bash\n# Check for notifications\nclawe check\n\n# List tasks\nclawe tasks\nclawe tasks --status in_progress\n\n# View task details\nclawe task:view \u003ctask-id\u003e\n\n# Update task status\nclawe task:status \u003ctask-id\u003e in_progress\nclawe task:status \u003ctask-id\u003e review\n\n# Add comments\nclawe task:comment \u003ctask-id\u003e \"Working on this now\"\n\n# Manage subtasks\nclawe subtask:add \u003ctask-id\u003e \"Research competitors\"\nclawe subtask:check \u003ctask-id\u003e 0\n\n# Register deliverables\nclawe deliver \u003ctask-id\u003e \"Final Report\" --path ./report.md\n\n# Send notifications\nclawe notify \u003csession-key\u003e \"Need your review on this\"\n\n# View squad status\nclawe squad\n\n# Activity feed\nclawe feed\n```\n\n## Agent Workspaces\n\nEach agent has an isolated workspace with:\n\n```\n/data/workspace-{agent}/\n├── AGENTS.md      # Instructions and conventions\n├── SOUL.md        # Agent identity and personality\n├── USER.md        # Info about the human they serve\n├── HEARTBEAT.md   # What to do on each wake\n├── MEMORY.md      # Long-term memory\n├── TOOLS.md       # Local tool notes\n└── shared/        # Symlink to shared state\n    ├── WORKING.md # Current team status\n    └── WORKFLOW.md # Standard operating procedures\n```\n\n## Customization\n\n### Adding New Agents\n\n1. Create workspace template in `docker/squadhub/templates/workspaces/{name}/`\n2. Add agent to `docker/squadhub/templates/config.template.json`\n3. Add agent to watcher's `AGENTS` array in `apps/watcher/src/index.ts`\n4. Rebuild: `docker compose build \u0026\u0026 docker compose up -d`\n\n### Changing Heartbeat Schedules\n\nEdit the `AGENTS` array in `apps/watcher/src/index.ts`:\n\n```typescript\nconst AGENTS = [\n  {\n    id: \"main\",\n    name: \"Clawe\",\n    emoji: \"🦞\",\n    role: \"Squad Lead\",\n    cron: \"0 * * * *\",\n  },\n  // Add or modify agents here\n];\n```\n\n## Development\n\n```bash\n# Install dependencies\npnpm install\n\n# Terminal 1: Start Convex dev server\npnpm convex:dev\n\n# Terminal 2: Start squadhub gateway in Docker\npnpm dev:docker\n\n# Terminal 3: Start web dashboard\npnpm dev:web\n\n# Or run everything together (Convex + web, but not squadhub)\npnpm dev\n```\n\n### Useful Commands\n\n```bash\n# Build everything\npnpm build\n\n# Type check\npnpm check-types\n\n# Lint and format\npnpm check      # Check only\npnpm fix        # Auto-fix\n\n# Deploy Convex to production\npnpm convex:deploy\n```\n\n## Environment Variables\n\n| Variable         | Required | Description                     |\n| ---------------- | -------- | ------------------------------- |\n| `SQUADHUB_TOKEN` | Yes      | Auth token for squadhub gateway |\n| `CONVEX_URL`     | Yes      | Convex deployment URL           |\n\nAPI keys (Anthropic, OpenAI) are managed via the UI during onboarding and in Settings \u003e General \u003e API Keys.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetclawe%2Fclawe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgetclawe%2Fclawe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetclawe%2Fclawe/lists"}