Swarmclaw

# SwarmClaw [](https://github.com/swarmclawai/swarmclaw/actions/workflows/ci.yml) [](https://github.com/swarmclawai/swarmclaw/releases) [](https://www.npmjs.com/package/@swarmclawai/swarmclaw) <p align="center"> <img src="https://raw.githubusercontent.com/swarmclawai/swarmclaw/main/public/branding/swarmclaw-org-avatar.png" alt="SwarmClaw lobster logo" width="120" /> </p> SwarmClaw is a self-hosted AI runtime for OpenClaw and multi-agent work. It helps you run autonomous agents and orchestrators with heartbeats, schedules, delegation, memory, runtime skills, and reviewed conversation-to-skill learning across OpenClaw gateways and other providers. GitHub: https://github.com/swarmclawai/swarmclaw Docs: https://swarmclaw.ai/docs Website: https://swarmclaw.ai Extension tutorial: https://swarmclaw.ai/docs/extension-tutorial ## Screenshots <table> <tr> <td width="50%"><img src="doc/assets/screenshots/org-chart.png" alt="SwarmClaw org chart view showing CEO, Developer, and Researcher agents." /></td> <td width="50%"><img src="doc/assets/screenshots/agent-chat.png" alt="SwarmClaw agent chat view showing a CEO conversation." /></td> </tr> <tr> <td align="center">_{Org chart for visualizing agent teams, delegation, and live activity.}</td> <td align="center">_{Agent chat with durable history, tools, and operator controls.}</td> </tr> </table> <div align="center"> <table> <tr> <td align="center"><strong>Works<br>with</strong></td> <td align="center"><img src="doc/assets/logos/openclaw.svg" width="32" alt="OpenClaw"><br>_OpenClaw</td> <td align="center"><img src="doc/assets/logos/claude-code.svg" width="32" alt="Claude Code"><br>_{Claude Code}</td> <td align="center"><img src="doc/assets/logos/codex.svg" width="32" alt="Codex"><br>_Codex</td> <td align="center"><img src="doc/assets/logos/gemini-cli.svg" width="32" alt="Gemini CLI"><br>_{Gemini CLI}</td> <td align="center"><img src="doc/assets/logos/opencode.svg" width="32" alt="OpenCode"><br>_OpenCode</td> <td align="center"><img src="doc/assets/logos/anthropic.svg" width="32" alt="Anthropic"><br>_Anthropic</td> <td align="center"><img src="doc/assets/logos/openai.svg" width="32" alt="OpenAI"><br>_OpenAI</td> <td align="center"><img src="doc/assets/logos/google.svg" width="32" alt="Google Gemini"><br>_Gemini</td> <td align="center"><img src="doc/assets/logos/ollama.svg" width="32" alt="Ollama"><br>_Ollama</td> <td align="center"><img src="doc/assets/logos/deepseek.svg" width="32" alt="DeepSeek"><br>_DeepSeek</td> <td align="center"><img src="doc/assets/logos/groq.svg" width="32" alt="Groq"><br>_Groq</td> <td align="center"><img src="doc/assets/logos/together.svg" width="32" alt="Together AI"><br>_Together</td> <td align="center"><img src="doc/assets/logos/mistral.svg" width="32" alt="Mistral AI"><br>_Mistral</td> <td align="center"><img src="doc/assets/logos/xai.svg" width="32" alt="xAI"><br>_xAI</td> <td align="center"><img src="doc/assets/logos/fireworks.svg" width="32" alt="Fireworks AI"><br>_Fireworks</td> <td align="center"><img src="doc/assets/logos/nebius.svg" width="32" alt="Nebius"><br>_Nebius</td> <td align="center"><img src="doc/assets/logos/deepinfra.svg" width="32" alt="DeepInfra"><br>_DeepInfra</td> </tr> </table> </div> ## Use Cases SwarmClaw is a general-purpose agent runtime. Here are some of the ways people use it. --- ### Personal Assistant A single agent with memory, web access, scheduling, and file tools — your always-available copilot. > *"Remember that I prefer window seats. Book research time every Monday at 9am. Summarize the articles I saved last week."* - Remembers preferences, contacts, and decisions across conversations - Schedules reminders, recurring check-ins, and follow-ups - Researches, drafts, plans, and manages your day-to-day - Bridges to WhatsApp or Telegram so you can message your agent on the go **Starter kit:** Personal Assistant &rarr; 1 agent, ready in under a minute. --- ### Virtual Company Build a full org chart of specialized agents that collaborate, delegate, and report up — a lightweight simulation of a real company. | Role | Agent | Responsibilities | |------|-------|-----------------| | **CEO** | Strategist | Sets objectives, reviews progress, delegates to department heads | | **CTO** | Builder | Owns technical execution, code reviews, architecture decisions | | **CFO** | Analyst | Tracks budgets, monitors token spend, produces cost reports | | **CMO** | Marketer | Drafts campaigns, manages content calendar, monitors channels | | **COO** | Operator | Coordinates cross-agent work, manages schedules, unblocks tasks | - Each agent has its own provider, model, personality (soul), and tool access - The CEO delegates via the task board; department heads pick up work autonomously - Heartbeat loops let agents check in on their own, surface blockers, and request approvals - Memory means every agent remembers past decisions and context - Connect the CMO to Discord/Slack so it can post updates directly --- ### Development Team A squad of agents mirroring a real engineering team — planning, building, reviewing, and testing in parallel. | Role | Agent | Tools | |------|-------|-------| | **Lead** | Architect | Delegation, tasks, schedules, missions | | **Dev** | Builder | Shell, files, Claude Code / Codex / OpenCode | | **QA** | Tester | Shell, browser, files, web search | | **Designer** | Creative | Image generation, browser, web search, files | | **Reviewer** | Critic | Files, web search, memory | - The Lead creates missions and breaks them into tasks on the board - Dev agents pick up tasks and delegate to Claude Code, Codex, or OpenCode for implementation - QA runs tests, takes screenshots, and files bugs back on the task board - The Reviewer audits PRs and flags regressions - Structured Sessions let you run a bounded sprint — plan → build → test → review — with durable transcripts **Starter kit:** Builder Studio &rarr; pre-configured Builder + Reviewer pair. --- ### Research Bureau Multiple research agents working in parallel, each with different search strategies, then synthesizing findings. - Spawn a swarm of researchers across different topics or sources - Each agent searches, fetches, reads, and summarizes independently - A lead agent collects outputs into a structured report with citations - Memory stores findings for future reference across conversations - Schedule recurring research runs (daily digest, weekly competitive scan) **Starter kit:** Research Copilot &rarr; 1 focused researcher, scale up with subagents. --- ### OpenClaw Fleet Distribute autonomous agents across multiple machines using OpenClaw gateways — one control plane, many runtimes. - Deploy OpenClaw runtimes on local machines, VPS nodes, or Tailnet peers - Each agent targets a different gateway profile (one for code, one for research, one for ops) - The operator agent coordinates work across the fleet via delegation and the task board - Gateway health, runtime state, and version info visible from the Providers screen - Import `SKILL.md` files from any OpenClaw instance into SwarmClaw's skill library **Starter kit:** OpenClaw Fleet &rarr; Operator + Remote Builder + Remote Researcher. --- ### Content Studio A writer/editor pipeline for blogs, docs, newsletters, marketing copy, or social posts. - **Writer** drafts content based on briefs, outlines, and style guides - **Editor** tightens structure, fixes tone, and flags missing evidence - Schedule daily or weekly content runs with automatic handoff - Connec