SwarmClaw

SwarmClaw is a self-hosted AI runtime for OpenClaw and multi-agent work. It helps you run autonomous agents 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

Release Notes

v1.0.8 Highlights

• Learned skills and self-healing: SwarmClaw now keeps agent-scoped learned skills and shadow revisions so repeated successes and repeated external integration failures can harden into reusable local behavior without silently mutating the shared skill library.
• Direct chat stability: chat-origin runs now stop after the visible answer instead of enqueueing hidden follow-up loops, leaked control tokens such as NO_MESSAGE stay out of the user transcript, and repeated internal reruns no longer replace the reply the user already saw.
• OpenClaw and Ollama route hardening: agent thread sessions now repair stale credential/endpoint resolution more aggressively, including Ollama Cloud vs local endpoint selection and OpenClaw gateway fallback behavior.
• Operator UX fixes: new agents appear in the list immediately, gateway-disconnected chat CTAs now route to the current agent's settings instead of global settings, setup-wizard flicker after access-key login is gone, and screenshot-heavy tool runs no longer render duplicate previews in chat.

What SwarmClaw Focuses On

• Delegation and background execution: delegated work, subagents, durable jobs, checkpointing, and background task execution.
• Autonomy and memory: heartbeats, schedules, long-running execution, durable memory, reflection memory, human-context learning, document recall, and project-aware context.
• OpenClaw integration: named gateway profiles, external runtimes, deploy helpers, config sync, approval handling, and OpenClaw agent file editing.
• Runtime skills: pinned skills, OpenClaw-compatible SKILL.md import, on-demand skill execution, and configurable keyword or embedding-based recommendation.
• Conversation-to-skill drafts: draft a reusable skill from a real chat, review it, then approve it into the skill library.
• Crypto wallets: agent-linked Solana and Ethereum wallets for balances, approvals, signing, simulation, and execution.
• Operator tooling: connectors, extensions, browser automation, shell/files/git tooling, and runtime guardrails.

OpenClaw

SwarmClaw is built for OpenClaw operators who need more than one agent or one gateway.

• Bundle and use the official openclaw CLI directly from SwarmClaw.
• Connect each SwarmClaw agent to a different OpenClaw gateway profile.
• Discover, verify, and manage multiple gateways from one control plane.
• Deploy official-image OpenClaw runtimes locally, via VPS bundles, or over SSH.
• Edit OpenClaw agent files such as SOUL.md, IDENTITY.md, USER.md, TOOLS.md, and AGENTS.md.
• Import OpenClaw SKILL.md files and use them in SwarmClaw’s runtime skill system.

Quick Start

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

Skill Drafts From Conversations

• From any active chat, use Draft Skill in the chat header.
• Or open Skills and use Draft From Current Chat.
• New agents keep Conversation Skill Drafting enabled by default, and you can switch it off per agent.
• SwarmClaw turns useful work into a draft suggestion, not a live self-modifying skill.
• Learned skills stay user/agent scoped by default. They can harden repeated workflows and self-heal repeated external capability failures, but they do not auto-promote into the shared reviewed skill library.
• Review the suggested name, rationale, summary, and transcript snippet.
• Approve it to save it into the normal skill library, or dismiss it.
• Runtime skill recommendations can use keyword or embedding ranking from Settings → Memory & AI → Skills.

Core Capabilities

• Providers: OpenClaw, OpenAI, Anthropic, Ollama, Google, DeepSeek, Groq, Together, Mistral, xAI, Fireworks, plus compatible custom endpoints.
• Delegation: built-in delegation to Claude Code, Codex CLI, OpenCode CLI, Gemini CLI, and native SwarmClaw subagents.
• Autonomy: heartbeat loops, schedules, background jobs, task execution, supervisor recovery, and agent wakeups.
• 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: balances, transfers, signatures, EVM call/quote/swap flows, and approval-gated execution.
• Connectors: Discord, Slack, Telegram, WhatsApp, Teams, Matrix, OpenClaw, and more.
• Extensions: external tool extensions, UI modules, hooks, and install/update flows.

Requirements

• Node.js 22.6+
• npm 10+ or another supported package manager
• Docker Desktop is recommended for sandbox/browser execution
• Optional provider CLIs if you want delegated CLI backends such as Claude Code, Codex, OpenCode, or Gemini

Security Notes

• First run creates an access key; keep it private.
• Do not expose port 3456 directly without a reverse proxy and TLS.
• Review agent prompts and enabled tools before granting shell, browser, wallet, or outbound capabilities.
• Wallet and outbound actions can be approval-gated globally.

Learn More

• Getting started: https://swarmclaw.ai/docs/getting-started
• OpenClaw setup: https://swarmclaw.ai/docs/openclaw-setup
• Agents: https://swarmclaw.ai/docs/agents
• Connectors: https://swarmclaw.ai/docs/connectors
• Extensions: https://swarmclaw.ai/docs/extensions
• CLI reference: https://swarmclaw.ai/docs/cli