Data lives in your OS app-data directory (~/Library/Application Support/SwarmClaw, %APPDATA%\SwarmClaw, or ~/.config/SwarmClaw), separate from any CLI or Docker install.

Global install

npm i -g @swarmclawai/swarmclaw
swarmclaw

yarn global add @swarmclawai/swarmclaw
swarmclaw

pnpm add -g @swarmclawai/swarmclaw
swarmclaw

bun add -g @swarmclawai/swarmclaw
swarmclaw

Running swarmclaw starts the server on http://localhost:3456.

From the repo

git clone https://github.com/swarmclawai/swarmclaw.git
cd swarmclaw
nvm use
npm run quickstart

npm run quickstart installs dependencies, prepares local config and runtime state, and starts SwarmClaw.

Docker

git clone https://github.com/swarmclawai/swarmclaw.git
cd swarmclaw
mkdir -p data
touch .env.local
docker compose up -d --build

Then open http://localhost:3456.

ClawHub Skill

Install the SwarmClaw skill for your OpenClaw agents:

clawhub install swarmclaw

Browse on ClawHub

Hosted Deploys

SwarmClaw now ships provider-ready deploy files at the repo root:

• render.yaml for Render Blueprint deploys from the public GHCR image
• fly.toml for Fly.io image-backed deploys
• railway.json for Railway-aligned health and restart defaults

The published image is:

ghcr.io/swarmclawai/swarmclaw:latest

Hosted deployments should:

• mount persistent storage at /app/data
• manage secrets through the provider dashboard
• set ACCESS_KEY and CREDENTIAL_SECRET
• point health checks at /api/healthz

Full hosted deployment guides live at https://swarmclaw.ai/docs/deployment

Core Capabilities

• Providers: 23 built-in — Claude Code CLI, Codex CLI, OpenCode CLI, Gemini CLI, Copilot CLI, Cursor Agent CLI, Qwen Code CLI, Goose, Anthropic, OpenAI, OpenRouter, Google Gemini, DeepSeek, Groq, Together, Mistral, xAI, Fireworks, Nebius, DeepInfra, Ollama, OpenClaw, and Hermes Agent, plus compatible custom endpoints.
• OpenRouter: Use OpenRouter as a first-class built-in provider with its standard OpenAI-compatible endpoint and routed model IDs such as openai/gpt-4.1-mini.
• Hermes Agent: Connect Hermes through its OpenAI-compatible API server, locally or through a reachable remote /v1 endpoint.
• Delegation: built-in delegation to Claude Code, Codex CLI, OpenCode CLI, Gemini CLI, Cursor Agent CLI, Qwen Code CLI, and native SwarmClaw subagents.
• Autonomy: heartbeat loops, schedules, background jobs, task execution, supervisor recovery, and agent wakeups.
• Orchestration: durable structured execution with branching, repeat loops, parallel branches, explicit joins, restart-safe run state, and contextual launch from chats, chatrooms, tasks, schedules, and API flows.
• Structured Sessions: reusable bounded runs with templates, facilitators, participants, hidden live rooms, chatroom /breakout, durable transcripts, outputs, operator controls, and a visible protocols template gallery plus visual builder.
• Memory: hybrid recall, graph traversal, journaling, durable documents, project-scoped context, automatic reflection memory, communication preferences, profile and boundary memory, significant events, and open follow-up loops.
• Wallets: linked Base wallet generation, address management, approval-oriented limits, and agent payout identity.
• Connectors: Discord, Slack, Telegram, WhatsApp, Teams, Matrix, OpenClaw, SwarmDock, SwarmFeed, and more.
• MCP Servers: connect any Model Context Protocol server (stdio, SSE, or streamable HTTP) and inject its tools into agents alongside built-ins. Configure, test, and assign per-agent from the MCP Servers panel.
• Extensions: external tool extensions, UI modules, hooks, and install/update flows.

What SwarmClaw Focuses On

• Delegation, orchestrators, and background execution: del