/ Diretório / Playground / swarmclaw
● Comunidade swarmclawai ⚡ Instantâneo

swarmclaw

por swarmclawai · swarmclawai/swarmclaw

Self-hosted multi-agent runtime — orchestrate Claude Code / Codex / OpenCode / native subagents, persistent memory, schedules, MCP integration, 23+ LLM providers.

SwarmClaw is a control plane for running teams of AI agents locally. Plug in LLMs (Claude, GPT, Gemini, OpenRouter, Ollama, etc.), attach MCP servers as tools, schedule autonomous loops, and persist memory with hybrid recall + graph traversal. Desktop installers for macOS/Windows/Linux, Docker Compose also supported.

Por que usar

Principais recursos

Demo ao vivo

Como fica na prática

swarmclaw.replay ▶ pronto
0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "swarmclaw": {
      "command": "npx",
      "args": [
        "-y",
        "swarmclaw"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "swarmclaw": {
      "command": "npx",
      "args": [
        "-y",
        "swarmclaw"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "swarmclaw": {
      "command": "npx",
      "args": [
        "-y",
        "swarmclaw"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "swarmclaw": {
      "command": "npx",
      "args": [
        "-y",
        "swarmclaw"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "swarmclaw",
      "command": "npx",
      "args": [
        "-y",
        "swarmclaw"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json
{
  "context_servers": {
    "swarmclaw": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "swarmclaw"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add swarmclaw -- npx -y swarmclaw

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: swarmclaw

Run an always-on research agent with SwarmClaw

👤 Researchers, competitive-intel analysts ⏱ ~45 min advanced

Quando usar: You want an agent that wakes up daily, runs a research loop, and drops results somewhere.

Pré-requisitos
  • SwarmClaw installed — One-click desktop installer or npm i -g @swarmclawai/swarmclaw
  • First-run access key — Generated on initial launch at http://localhost:3456
Fluxo
  1. Define the agent
    Create a SwarmClaw agent 'daily-ai-news' with provider=Claude, memory=enabled, schedule='every day 08:00'.✓ Copiado
    → Agent registered
  2. Attach tools via MCP
    Attach firecrawl + notion MCPs so the agent can scrape and write results to Notion.✓ Copiado
    → Tools wired
  3. Let it run
    Enable the schedule. Review memory weekly to see what it's learned.✓ Copiado
    → Daily Notion pages appear

Resultado: A background research teammate.

Armadilhas
  • LLM cost spiral on long loops — Set per-session token budgets in the agent config; alert on overrun
Combine com: firecrawl

Delegate coding tasks across multiple models with SwarmClaw

👤 Engineers who want quality-vs-speed tradeoffs per sub-task ⏱ ~60 min advanced

Quando usar: A feature has planning (Opus), bulk coding (Sonnet), and polish (Codex) phases.

Fluxo
  1. Define the pipeline
    Create a workflow: planner=Claude Opus, coder=Claude Sonnet via Claude Code, reviewer=Codex. Handoffs via transcript.✓ Copiado
    → Workflow visible in UI
  2. Run on a task
    Run the workflow on feature spec [paste]. Watch the handoffs.✓ Copiado
    → Final PR proposal after each stage contributes

Resultado: Right tool for each phase of a single feature.

Combine com: github

Build a memory-rich personal assistant with SwarmClaw

👤 Power users who dislike re-explaining context each session ⏱ ~30 min intermediate

Quando usar: Your ChatGPT/Claude sessions lose context you wanted retained across days.

Fluxo
  1. Enable hybrid memory
    Create a long-lived session 'assistant' with hybrid memory (vector + graph). Pipe all prior transcripts into the memory.✓ Copiado
    → Memory populated
  2. Ask and let it recall
    What were my open questions from last Tuesday's session about pricing?✓ Copiado
    → Recalled items with citations to source sessions

Resultado: An assistant that actually remembers.

Combinações

Combine com outros MCPs para 10× de alavancagem

swarmclaw + claude-code

SwarmClaw orchestrates; Claude Code is the coder in the loop

Delegate the 'implement-feature' step to Claude Code via the swarmclaw workflow.✓ Copiado
swarmclaw + firecrawl

Scheduled scraping + memory-enriched analysis

Daily agent: scrape competitor pages, diff against memory, flag changes.✓ Copiado

Ferramentas

O que este MCP expõe

FerramentaEntradasQuando chamarCusto
create_agent name, provider, memory?, schedule? Bootstrap a new agent 0
attach_mcp agent_id, mcp_config Give the agent tools 0
run_session agent_id, input Ad-hoc invocation LLM tokens
schedule_agent agent_id, cron Long-running autonomy 0
memory_query agent_id, query Inspect agent memory 0

Custo e limites

O que custa rodar

Cota de API
Whatever your LLM providers enforce
Tokens por chamada
Multi-turn sessions with memory retrieval: 3-30k per step
Monetário
Free self-hosted; LLM token costs are yours
Dica
Set hard per-session budgets; autonomous loops can spend unnoticed

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: LLM keys encrypted in the local data dir; first-run access key protects the UI
Saída de dados: To each configured LLM provider + attached MCPs
Nunca conceda: internet-exposing the UI without auth — default is localhost only

Solução de problemas

Erros comuns e correções

UI inaccessible after install

SwarmClaw binds to 127.0.0.1:3456; ensure nothing else owns that port. lsof -i :3456

Agent loops spend tokens in the background

Disable its schedule and inspect last transcripts; set a token budget on the agent before re-enabling

MCP server fails to start under swarmclaw

Test the MCP command manually first (with f/mcptools); swarmclaw uses the same invocation

Verificar: mcp tools -- <your-mcp-cmd>

Alternativas

swarmclaw vs. outros

AlternativaQuando usarTroca
n8n-workflow-builderYou want deterministic workflow automation not agent loopsLess agentic; no LLM memory
LangGraph / AutogenYou want code-first orchestration in your own appYou host + write everything

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills