/ Annuaire / Playground / swarmclaw
● Communauté swarmclawai ⚡ Instantané

swarmclaw

par 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.

Pourquoi l'utiliser

Fonctionnalités clés

Démo en direct

Aperçu en pratique

swarmclaw.replay ▶ prêt
0/0

Installer

Choisissez votre client

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

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

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

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

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

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add swarmclaw -- npx -y swarmclaw

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : swarmclaw

Run an always-on research agent with SwarmClaw

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

Quand l'utiliser : You want an agent that wakes up daily, runs a research loop, and drops results somewhere.

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

Résultat : A background research teammate.

Pièges
  • LLM cost spiral on long loops — Set per-session token budgets in the agent config; alert on overrun
Combiner avec : firecrawl

Delegate coding tasks across multiple models with SwarmClaw

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

Quand l'utiliser : A feature has planning (Opus), bulk coding (Sonnet), and polish (Codex) phases.

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

Résultat : Right tool for each phase of a single feature.

Combiner avec : github

Build a memory-rich personal assistant with SwarmClaw

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

Quand l'utiliser : Your ChatGPT/Claude sessions lose context you wanted retained across days.

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

Résultat : An assistant that actually remembers.

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

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.✓ Copié
swarmclaw + firecrawl

Scheduled scraping + memory-enriched analysis

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

Outils

Ce que ce MCP expose

OutilEntréesQuand appelerCoût
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

Coût et limites

Coût d'exécution

Quota d'API
Whatever your LLM providers enforce
Tokens par appel
Multi-turn sessions with memory retrieval: 3-30k per step
Monétaire
Free self-hosted; LLM token costs are yours
Astuce
Set hard per-session budgets; autonomous loops can spend unnoticed

Sécurité

Permissions, secrets, portée

Stockage des identifiants : LLM keys encrypted in the local data dir; first-run access key protects the UI
Sortie de données : To each configured LLM provider + attached MCPs
Ne jamais accorder : internet-exposing the UI without auth — default is localhost only

Dépannage

Erreurs courantes et correctifs

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

Vérifier : mcp tools -- <your-mcp-cmd>

Alternatives

swarmclaw vs autres

AlternativeQuand l'utiliserCompromis
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

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills