swarmclaw

SwarmClaw

SwarmClaw is an open-source, self-hosted AI agent runtime and multi-agent framework. Run autonomous AI agents, agent swarms, and orchestrators with heartbeats, schedules, delegation, agent memory, runtime skills, and reviewed conversation-to-skill learning — across OpenClaw gateways, Claude, GPT, Gemini, OpenRouter, Ollama, and 23+ other providers. Use it as your AI agent dashboard, agent orchestration platform, and home base for self-hosted multi-agent AI workflows.

GitHub: https://github.com/swarmclawai/swarmclaw
Docs: https://swarmclaw.ai/docs
Website: https://swarmclaw.ai
Discord: https://discord.gg/sbEavS8cPV
Extension tutorial: https://swarmclaw.ai/docs/extension-tutorial

Screenshots

Requirements

• Node.js 22.6+ (nvm use will pick up the repo's .nvmrc, which matches CI)
• 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, Gemini, Copilot, Factory Droid, Cursor Agent, Qwen Code, or Goose

Quick Start

Desktop app (recommended for non-technical users)

Download the one-click installer from swarmclaw.ai/downloads. Available for macOS (Apple Silicon & Intel), Windows, and Linux (AppImage + .deb).

The release workflow supports Developer ID signing and notarization when Apple credentials are configured. If a macOS build is still ad-hoc signed, first launch may need one manual approval:

• macOS: signed/notarized releases publish both .dmg and .zip; unsigned fallback releases publish .zip only to avoid the damaged unsigned DMG path. Right-click the app in Finder → Open → Open to bypass Gatekeeper. If macOS instead reports "SwarmClaw is damaged and can't be opened" (common when a downloaded app was quarantined by Safari), strip the quarantine attribute and relaunch:

  xattr -dr com.apple.quarantine /Applications/SwarmClaw.app
  

• Windows: if SmartScreen appears, click More info → Run anyway.
• Linux (AppImage): chmod +x the downloaded file, then run it.

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:

openclaw skills install swarmclaw

Browse on ClawHub

v1.9.39 Highlights

Scheduled-run reliability release: stale workspace rebinding, fail-fast credential checks, and durable delivery evidence for schedule-driven sends.

• Legacy workspace cwd migration. Scheduled reruns and reused schedule sessions pinned to a pre-migration workspace root (e.g. ~/.swarmclaw/workspace) are now rebound to the current WORKSPACE_DIR automatically; intentional custom working directories are never touched.
• Orphan recovery dedup. Startup queue recovery now recovers each orphaned task once instead of re-logging it every tick, and dead-letters tasks that repeatedly return to the queue without starting.
• Schedule delivery status. Every scheduled run now writes lastDeliveryStatus/lastDeliveryError back to its schedule, so failures are visible without digging through task records.
• Credential preflight for schedules. Scheduled runs on API-key providers fail fast with an actionable error when no credential resolves, instead of dying on a 401 deep in execution.
• Empty-run classification. Runs that produce no text, no tool calls, and no error now fail with a clear provider-configuration message instead of a generic validation failure.
• Durable connector delivery evidence. Task follow-up sends route through the connector outbox with task/schedule linkage, retries with backoff, and per-run dedupe, so triage can prove whether a scheduled send succeeded, failed, or was never attempted.
• Regression coverage. Added tests for workspace path normalization, orphan recovery, schedule outcome writes, credential preflight, empty-run classification, and outbox-backed follow-ups.

v1.9.38 Highlights

PR integration release for provider catalog coverage, OpenRouter context meters, and safer unsigned macOS desktop artifacts.

• TokenMix provider. Added TokenMix as a built-in OpenAI-compatible provider with setup metadata, starter-agent defaults, and provider health checks.
• OpenRouter context meters. Chat context status now uses cached OpenRouter model metadata when available so routed model context windows display accurately.
• macOS unsigned artifact fallback. Desktop releases publish zip-only macOS artifacts when signing/notarization inputs are missing, avoiding the unsigned DMG damaged-app path.
• Regression coverage. Added targeted tests for TokenMix setup, OpenRouter context metadata caching, and macOS target selection.

v1.9.37 Highlights

Theme and memory-pressure release for lighter UI preferences and leaner chat history storage.

• Light, dark, and system theme modes. Settings → Appearance now persists a Light/Dark/System selector while keeping the existing hue presets and custom color picker.
• Lean session history storage. Legacy transcript blobs migrate into the session_messages table and are compacted from session records after persistence is verified, reducing page-load memory pressure on lower-RAM devices.
• Repo-backed message readers. Global search, live usage summaries, and OpenClaw history merge now read table-backed messages after transcript compaction.
• Regression coverage. Added tests for theme-mode normalization, legacy transcript compaction, and repo-backed message search.

v1.9.36 Highlights

Protocol builder visibility release for built-in Structured Sessions.

• Built-in flow inspector. Built-in protocol templates now open in a full-size visual builder canvas with a read-only template step panel.
• Canvas viewport repair. Builder routes now claim the full dashboard workspace and refit React Flow after async template loads.
• Regression coverage. Browser smoke now verifies that the built-in facilitated discussion graph renders with visible flow nodes.

v1.9.35 Highlights

Installed package build fix for fresh npm-global installs and upgrades.

• Fallback build dependency fix. The npm package now declares mime-types and @types/mime-types directly so swarmclaw server --build can type-check the OpenClaw media proxy on clean installs.