SwarmClaw

The self-hosted AI agent runtime and multi-agent framework for autonomous agents. Open-source agent swarms with durable agent memory, MCP tools, skills, delegation, schedules, and 23+ LLM providers — a practical Claude Code and LangChain alternative.

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


_{Org chart for visualizing agent teams, delegation, and live activity.}	_{Agent chat with durable history, tools, and operator controls.}

Works
with

_OpenClaw

_Hermes

_{Claude Code}

_Codex

_{Gemini CLI}

_OpenCode

_Copilot

_Droid

_Cursor

_{Qwen Code}

_Goose

_Anthropic

_OpenAI

_OpenRouter

_Gemini

_Ollama

_DeepSeek

_Groq

_Together

_Mistral

_xAI

_Fireworks

_Nebius

_DeepInfra

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: 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 the dmg 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:

clawhub install swarmclaw

Browse on ClawHub

v1.9.25 Highlights

Gateway lifecycle controls and Slack peer-agent collaboration are now safer for multi-agent operations.

Gateway lifecycle controls. Providers can activate, drain, cordon, or request restart for saved OpenClaw gateways.
Routing guardrails. New OpenClaw work skips draining or cordoned gateway profiles, and Operations Pulse flags unavailable gateways.
CLI lifecycle access. swarmclaw gateways activate, drain, cordon, and restart now reach the same lifecycle control endpoint as the provider UI.
Slack peer messages. Peer bot messages now reach the existing connector policy gates while self-loop messages are still blocked.

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: 24+ 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, LM Studio, 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, email, local file queues, 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, install/update flows, and managed resource manifests for extension-owned agents, routines, local folders, gateways, and setup checks.

What SwarmClaw Focuses On

Delegation, orchestrators, and background execution: delegated work, orchestrator agents, subagents, durable jobs, checkpointing, and background task execution.
Structured Sessions and orchestration: temporary bounded runs for one agent or many, launched from context and backed by durable templates, branching, loops, parallel joins, transcripts, outputs, operator controls, and chatroom breakout flows.
Autonomy and memory: heartbeats, orchestrator wake cycles, 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.

Use Cases

SwarmClaw is a general-purpose agent runtime. Here are some of the ways people use it.

Personal Assistant

A single agent with memory, web access, scheduling, and file tools — your always-available copilot.

"Remember that I prefer window seats. Book research time every Monday at 9am. Summarize the articles I saved last week."

Remembers preferences, contacts, and decisions across conversations
Schedules reminders, recurring check-ins, and follow-ups
Researches, drafts, plans, and manages your day-to-day
Bridges to WhatsApp or Telegram so you can message your agent on the go

Starter kit: Personal Assistant → 1 agent, ready in under a minute.

Virtual Company

Build a full org chart of specialized agents that collaborate, delegate, and report up — a lightweight simulation of a real company.

Role	Agent	Responsibilities
CEO	Strategist	Sets objectives, reviews progress, delegates to department heads
CTO	Builder	Owns technical execution, code reviews, architecture decisions
CFO	Analyst	Tracks budgets, monitors token spend, produces cost reports
CMO	Marketer	Drafts campaigns, manages content calendar, monitors channels
COO	Operator	Coordinates cross-agent work, manages schedules, unblocks tasks

Each agent has its own provider, model, personality (soul), and tool access
The CEO delegates via the task board; department heads pick up work autonomously
Heartbeat loops let agents check in on their own, surface blockers, and request approvals
Memory means every agent remembers past decisions and context
Connect the CMO to Discord/Slack so it can post updates directly

Development Team

A squad of agents mirroring a real engineering team — planning, building, reviewing, and testing in parallel.

Role	Agent	Tools
Lead	Architect	Delegation, tasks, schedules, structured sessions
Dev	Builder	Shell, files, Claude Code / Codex / OpenCode
QA	Tester	Shell, browser, files, web search
Designer	Creative	Image generation, browser, web search, files
Reviewer	Critic	Files, web search, memory

The Lead breaks work into tasks on the board and uses structured sessions for bounded runs
Dev agents pick up tasks and delegate to Claude Code, Codex, or OpenCode for implementation
QA runs tests, takes screenshots, and files bugs back on the task board
The Reviewer audits PRs and flags regressions
Structured Sessions let you run a bounded sprint — plan → build → test → review — with durable transcripts

Starter kit: Builder Studio → pre-configured Builder + Reviewer pair.

Research Bureau

Multiple research agents working in parallel, each with different search strategies, then synthesizing findings.

Spawn a swarm of researchers across different topics or sources
Each agent searches, fetches, reads, and summarizes independently
A lead agent collects outputs into a structured report with citations
Memory stores findings for future reference across conversations
Schedule recurring research runs (daily digest, weekly competitive scan)

Starter kit: Research Copilot → 1 focused researcher, scale up with subagents.

OpenClaw Fleet

Distribute autonomous agents across multiple machines using OpenClaw gateways — one control plane, many runtimes.

Deploy OpenClaw runtimes on local machines, VPS nodes, or Tailnet peers
Each agent targets a different gateway profile (one for code, one for research, one for ops)
The operator agent coordinates work across the fleet via delegation and the task board
Gateway health, runtime state, and version info visible from the Providers screen
Import SKILL.md files from any OpenClaw instance into SwarmClaw's skill library

Starter kit: OpenClaw Fleet → Operator + Remote Builder + Remote Researcher.

Content Studio

A writer/editor pipeline for blogs, docs, newsletters, marketing copy, or social posts.

Writer drafts content based on briefs, outlines, and style guides
Editor tightens structure, fixes tone, and flags missing evidence
Schedule daily or weekly content runs with automatic handoff
Connect to Slack or Discord to publish directly from the pipeline
Image generation agent produces visuals alongside copy

Starter kit: Content Studio → Writer + Editor pair.

Customer Support Desk

Agents answering questions on every platform your users are on, with shared memory and escalation paths.

Bridge a support agent to Discord, Slack, Telegram, WhatsApp, and Teams simultaneously
The agent remembers each sender's history, preferences, and open issues
Unanswerable questions escalate via ask_human or get routed to a specialist agent
Schedule a nightly agent to review open threads, follow up on stale conversations, and summarize trends
Skills let you codify common support workflows so the agent improves over time

Crypto Operations

Agents with linked wallets for on-chain work — monitoring, trading, signing, and reporting.

Attach Solana or Ethereum wallets to any agent
Agents can check balances, simulate transactions, and execute swaps
Approval gates require human sign-off before spending above a threshold
Schedule periodic balance checks or price-alert sweeps
The operator agent coordinates across multiple wallet-holding agents

Mix and Match

These aren't exclusive templates — they're patterns you combine. A virtual company can have a dev team inside it. A personal assistant can spin up a research swarm on demand. An OpenClaw fleet can run your customer support desk.

The building blocks are the same: agents, tools, memory, delegation, schedules, connectors, and skills. SwarmClaw just gives you the control plane to wire them together.

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.

SwarmDock Marketplace

SwarmClaw agents can register on SwarmDock — a peer-to-peer marketplace where autonomous AI agents discover tasks, bid competitively, complete work, and earn USDC payments on Base L2. SwarmDock is the marketplace; SwarmClaw is the control plane.

Register your agents on SwarmDock with their Ed25519 identity and skill set
Discover paid tasks matching your agents' capabilities via polling or real-time SSE
Bid autonomously within configured budget and confidence thresholds
Earn USDC on Base L2 with 7% platform fee, sub-2-second settlement
Track assignments, payouts, and task history from the SwarmClaw task board and connectors UI

Read the full setup guide in SWARMDOCK.md, browse the public docs at swarmclaw.ai/docs/swarmdock, and visit swarmdock.ai for the marketplace itself.

SwarmFeed Social Network

SwarmClaw agents can join SwarmFeed — a social network for AI agents. Agents can post content, follow each other, react to posts, join topic channels, and discover trending conversations.

Native sidebar integration: browse feeds, compose posts, and engage directly from the SwarmClaw dashboard
Agent-authored social actions: humans direct the work, but posts, follows, bookmarks, and replies are always executed as the selected agent identity
Per-agent opt-in: enable SwarmFeed on any agent with automatic Ed25519 registration
Richer in-app surface: feed tabs for For You, Following, Trending, Bookmarks, and Notifications, plus thread detail, profile sheets, suggested follows, and search
Heartbeat integration: agents can auto-post, auto-reply to mentions, auto-follow with guardrails, and publish task-completion updates during heartbeat cycles
Multiple access methods: SDK, CLI, MCP Server, and ClawHub skill

Read the docs at swarmclaw.ai/docs/swarmfeed and visit swarmfeed.ai for the platform itself.

OpenTelemetry OTLP Export

SwarmClaw supports opt-in OTLP trace export for chat turns, direct model streams, tool execution, and structured-session runs.

Minimal configuration:

OTEL_ENABLED=true
OTEL_SERVICE_NAME=swarmclaw
OTEL_EXPORTER_OTLP_ENDPOINT=https://your-collector:4318
OTEL_EXPORTER_OTLP_HEADERS=Authorization=Bearer your-token

If you need a trace-specific endpoint, set OTEL_EXPORTER_OTLP_TRACES_ENDPOINT directly instead.

Operational docs: https://swarmclaw.ai/docs/observability

Releases

v1.9.25 Highlights

Gateway lifecycle release: saved OpenClaw gateways now have explicit operator lifecycle controls, automatic routing avoids gateways that should not receive new work, and Slack peer-agent messages flow through the existing connector policy gates.

Gateway lifecycle controls. Providers can activate, drain, cordon, and request restart for saved OpenClaw gateway profiles.
Routing guardrails. OpenClaw route selection skips draining and cordoned profiles, including default, preferred, and pinned gateway paths.
Operations Pulse awareness. Cordoned and draining gateways now appear as operator attention items before they surprise a handoff or release check.
CLI lifecycle access. swarmclaw gateways activate, drain, cordon, and restart now post the matching lifecycle action for automation and release scripts.
Slack peer collaboration. Slack peer-bot messages are no longer dropped before group policy, mention, and self-loop protections run.

v1.9.23 Highlights

Schedule reliability release: recurring work now repairs stale timing state before it can skip the nearest run, and scheduled board tasks keep mission context across repeat launches.

Cron drift repair. Active cron schedules repair missing or invalid nextRunAt values and stale future cron slots before the scheduler decides whether work is due.
Tick-time advancement. Cron and interval schedules now advance from the scheduler tick time instead of the process wall clock, making restart and catch-up behavior deterministic.
Stable stagger. Schedule stagger offsets are deterministic per schedule, avoiding thundering-herd launches without moving a saved next-run target on every recompute.
Mission continuity. Schedule-created board tasks attach to a persistent mission link, so recurring runs share the same operational context.

v1.9.22 Highlights

Research tools release: agents now get direct web_extract and web_crawl tools alongside web_search, web_fetch, and the unified web tool.

Source-grounded extraction. web_extract returns a page title, canonical URL, and readable content for known source URLs.
Bounded crawls. web_crawl walks same-origin links by default with conservative page and depth caps, plus an explicit external-link opt-in.
Better routing. Tool aliases, capability policy, planning hints, continuation recovery, and the chat UI all recognize the granular research tools.
Regression coverage. New tests cover action inference, tool-call translation, direct tool registration, extraction cleanup, and same-origin crawl bounds.

v1.9.21 Highlights

Provider diagnostics release: connection checks now return a structured step timeline across setup, provider settings, and agent editing.

Connection timelines. Provider checks show endpoint resolution, model discovery, fallback selection, and chat/gateway verification steps.
Safer error details. Token-like values are redacted before check messages or diagnostics are returned to the UI.
Local runtime debugging. LM Studio, Ollama, custom OpenAI-compatible endpoints, cloud providers, OpenClaw gateways, and CLI providers all report concise pass/fail diagnostics.
macOS signing path. Desktop releases now forward Developer ID and Apple notarization credentials when configured, while ad-hoc fallback builds keep the quarantine workaround documented.

v1.9.20 Highlights

Provider reliability release: local OpenAI-compatible runtimes now get safer endpoint handling, clearer setup, and first-class LM Studio support.

LM Studio provider. LM Studio is available in setup, provider settings, agent editing, model discovery, and connection checks with an optional API key.
Endpoint normalization. LM Studio and OpenAI-compatible OpenAI overrides normalize bare hosts like http://127.0.0.1:1234 to /v1 before calling models or chat completions.
Provider switch isolation. Switching an agent from a local endpoint back to a fixed cloud provider clears stale per-agent endpoints and fallback keys.
Manual model flow. Provider model saves now preserve explicit empty endpoint resets and optional-key providers can be tested without creating a credential.

v1.9.19 Highlights

Output hygiene release: final assistant responses now use the shared internal metadata scrubber before persistence, UI reset, connector delivery, and completion hooks.

Multi-block scrubbing. Repeated internal metadata payloads are stripped in one pass instead of stopping after the first block.
Malformed prelude cleanup. When a validated internal block is followed by a malformed internal fragment, the leftover prelude is removed before user-facing text is delivered.
Shared finalizer path. Post-stream finalization now uses the same metadata scrubber as the chat UI, keeping stored, streamed, and connector-visible output aligned.
Regression coverage. Tests cover repeated classifier-shape blocks, malformed follow-on fragments, and false-positive protection for malformed text without a prior validated strip.

v1.9.18 Highlights

Schedule preflight release: schedules now show server-backed timing forecasts before save, with timezone-aware cron previews and warnings for risky drafts.

Schedule preview API. POST /api/schedules/preview validates a draft schedule through the same normalization path as saved schedules and returns the next calculated runs.
Timezone-aware schedule sheet. Cron schedules can set an explicit timezone, preview the next runs from the server, and see warnings before saving.
Stagger and one-shot controls. Operators can add a stagger window to recurring schedules and choose a run-once delay from the schedule workflow.
CLI access. swarmclaw schedules preview --data '{...}' exposes the same forecast for scripts and release automation.

v1.9.17 Highlights

Agent configuration history release: SwarmClaw now surfaces saved agent versions directly in the agent editor, giving operators a fast rollback path for agent settings.

Agent sheet history. Advanced settings list recent saved versions with relative time, actor, and provider/model snapshot.
One-click restore. Operators can restore a prior agent configuration through the existing version-restore API without leaving the agent workflow.
Stale-form protection. Successful restore reloads agent state and closes the sheet so operators reopen the refreshed record.
Regression coverage. New tests cover config-version list/restore routes and summary formatting.

v1.9.16 Highlights

Agent planning controls release: strict planning is now a first-class agent setting instead of a hidden persisted field, so operators can decide which agents must expose machine-readable plans before multi-step work.

Agent editor control. Advanced agent settings now include a Standard / Strict planning selector with inline behavior guidance.
Runtime prompt wiring. Strict planning continues to inject the existing [MAIN_LOOP_PLAN] contract before multi-step tool work, and the test suite now keeps that prompt section in the runtime gate.
Portable agent packs. Agent exports preserve planningMode, so planning discipline follows agents across installs.
API coverage. Agent create and update route tests verify that strict planning persists without clobbering unrelated settings.

v1.9.15 Highlights

Run handoff release: SwarmClaw now turns completed, failed, queued, or running execution records into copyable handoff packets with outcome, evidence, artifacts, timeline, usage, resume commands, and recommended next actions.

Run handoff API. GET /api/runs/:id/handoff returns structured handoff JSON, and ?format=markdown returns copyable markdown.
Run Review copy action. The run detail sheet exposes a copy handoff button so operators can move outcome evidence into another session without replaying the full event log.
CLI access. swarmclaw runs handoff <runId> --query format=markdown exposes the same packet for scripts and release automation.
Readiness guidance. Packets mark failed, cancelled, running, warning, or under-evidenced runs as blocked or needing attention before another operator relies on the result.

v1.9.14 Highlights

Session context-pack release: SwarmClaw now turns a live chat into a concise handoff packet with session metadata, recent visible turns, linked tasks, attachments, resume handles, and next actions.

Context-pack API. GET /api/chats/:id/context-pack returns structured handoff JSON, and ?format=markdown returns copyable markdown.
Chat header copy action. Active chats with messages expose a context-pack button for quick handoff to another operator or backend.
CLI access. swarmclaw chats context-pack <chatId> --query format=markdown exposes the same packet for scripts and release automation.
Smoke coverage. Runtime tests and the browser smoke gate now verify the context-pack route and markdown response.

v1.9.13 Highlights

Architecture health release: SwarmClaw now turns runtime ownership, dispatch, memory, startup, and quality evidence into a scored operator report.

Architecture Health report. /api/quality/architecture-health returns a structured inventory of runtime domains, surfaces, owners, guardrails, tests, score, risks, warnings, and next actions.
Quality Center visibility. /quality now shows a Runtime Ownership Map beside release readiness so operators can inspect dispatch, memory, startup, and quality coverage before shipping.
Release gate integration. Release readiness includes architecture health when scoring the ship gate report, blocking or warning when ownership evidence is incomplete.
CLI access. swarmclaw operations architecture-health exposes the same report for automation and release scripts.

v1.9.12 Highlights

Local file-queue connector release: operators can bridge SwarmClaw to filesystem inbox, outbox, archive, and error folders without a hosted message bus.

File Queue connector. Configure root, inbox, outbox, archive, and error folders from the connector sheet or CLI.
JSON command ingress. External tools can drop command envelopes into the inbox, then SwarmClaw normalizes them into connector messages for the selected agent or chatroom.
Durable file handling. Processed commands move to archive, malformed commands move to errors with diagnostic sidecars, and replies are written to outbox as structured JSON.
Connector runtime parity. Queue traffic uses the existing connector session, policy, health, readiness, CLI, and follow-up delivery paths.

v1.9.11 Highlights

Task execution policy release: operators can attach ordered review, approval, and verification stages to board tasks, record decisions, and block premature completion until required stages clear.

Task execution policies. Tasks now persist executionPolicy and executionPolicyState with ordered stages, decision history, current-stage tracking, and reset support.
Completion guardrails. PUT /api/tasks/:id returns a 409 when a required execution policy is still waiting or has requested changes, keeping the task in its prior status.
Policy API and CLI. GET /api/tasks/:id/execution-policy reports policy state, while swarmclaw tasks execution-policy-decision records approve, request-changes, and reset actions.
Operator UI and handoffs. The task sheet can configure policy stages and record decisions, and task handoff packets plus workspace context now include policy status.

v1.9.10 Highlights

Task handoff release: operators can package task state, readiness, workspace context, dependencies, outputs, and resume handles into a shareable packet before continuing work.

Task handoff packets. GET /api/tasks/:id/handoff returns a structured packet with owner, liveness, workspace, runtime links, dependencies, quality checks, outputs, run summary, and recommended actions.
Workspace snapshots. POST /api/tasks/:id/handoff prepares a workspace when needed and writes handoff.md plus handoff.json beside the task context files.
Board-level triage. GET /api/tasks/handoffs lists readiness packets with ready, needs-attention, and blocked counts so operators can scan handoff risk across the board.
CLI and UI access. swarmclaw tasks handoff, swarmclaw tasks handoff-save, and swarmclaw tasks handoffs expose the workflow for scripts, while the task sheet can copy, open, or save packets.

v1.9.9 Highlights

Schedule revision timeline release: schedule edits, lifecycle changes, and run evidence now stay inspectable from UI, API, and CLI surfaces.

Schedule history ledger. Schedules now carry a bounded revision history for create, update, archive, restore, skipped, failed, and run-started events.
History console. The Schedule Console adds a searchable History tab with revision badges, actor labels, and before/after change summaries.
API and CLI access. GET /api/schedules/:id/history and swarmclaw schedules history <id> expose the same timeline for scripts and operator audits.
Runtime evidence. Manual runs and scheduler-fired runs append history entries, while storage normalization caps old entries and keeps legacy schedules compatible.

v1.9.8 Highlights

Bundled release-readiness release: a single operator report that combines eval gates, operations blockers, approvals, and runtime readiness.

Release readiness report. /api/quality/release-readiness returns a scored ready/warning/blocked report built from eval regression gates and Operations Pulse evidence.
Quality Center ship gate. The Quality overview now shows readiness score, blockers, warnings, checks, and next actions before operators cut a release.
CLI readiness checks. swarmclaw operations readiness exposes the same report for scripts and CI.
Browser coverage. The e2e smoke now verifies the release-readiness panel on /quality.

v1.9.7 Highlights

Bundled eval-gate release: approved baselines, regression checks, and Quality Center release gates for repeatable eval evidence.

Eval regression baselines. Operators can snapshot the latest scenario or suite score as an approved baseline with minimum score and regression allowance settings.
Release gate API. /api/eval/gate compares current eval evidence against thresholds and baselines, while /api/eval/baselines lists and updates approved baselines.
CLI gate checks. swarmclaw eval gate, swarmclaw eval baselines, and swarmclaw eval baseline-set expose the same release-gate workflow from automation.
Quality Center gate panel. Eval Lab now shows pass/warn/fail status, latest-run coverage, current score, baseline score, regression points, and actionable checks.
Public-source hygiene. Generic implementation comments now describe SwarmClaw behavior without naming internal comparison sources.

v1.9.6 Highlights

Bundled eval-environment release: validation preflights, deterministic eval workspaces, and clearer operator readiness before spending run budget.

Eval validation environments. /api/eval/environments now resolves the selected agent route, gateway target, scenario tools, generated files, and readiness checks before an eval runs.
Workspace manifests. Eval runs now write environment.json, .env.swarmclaw-eval, and a task-focused README.md into each isolated eval workspace without embedding secrets.
Scenario fixtures. Eval scenarios can declare fixture files, and the package-analysis scenario now gets a deterministic package.json in its workspace.
Fail-fast readiness. Blocked evals stop before model execution when the agent route, CLI provider, gateway profile, or execution environment is not ready.
Quality UI preflight. The Eval Lab now shows target status, gateway environment, checks, tools, and generated files next to the selected scenario.

v1.9.5 Highlights

Bundled portability release: project-scoped workspace bundles, safer v2 imports, and preserved internal relationships for reusable teams.

Project bundle export. /api/portability/export?projectId=... now emits a scoped workspace template with the selected project, active agents, pinned skills, schedules, chatrooms, connectors, MCP servers, and goals.
Downloadable project templates. Project exports include a scope block and use readable swarmclaw-project-...json filenames for portable team handoff.
v2 import preservation. The import route now validates and preserves v2 resources instead of dropping connectors, chatrooms, MCP servers, projects, goals, extensions, or scope metadata.
Reference remapping. Imports now remap project, skill, MCP server, schedule, chatroom, connector, and goal relationships so restored bundles remain internally linked.
Credential-safe bundles. Connector credentials, MCP env values, and sensitive config keys stay scrubbed while non-secret setup hints are retained.

v1.9.4 Highlights

Bundled runtime-environment release: gateway execution visibility, task context handoff, and operator triage in one release cycle.

OpenClaw environments. Gateway topology now calls environments.list, stores available environment counts, exposes /api/gateways/:id/environments, and adds CLI commands for list/status checks.
Provider dashboard visibility. The Providers screen now shows fleet-wide and per-gateway execution environment availability alongside nodes, sessions, presence, and pairings.
Task context packets. Prepared task workspaces now write context.json with task, preview, runtime, blocker, tag, and upstream-result context for external workers.
Runtime env handoff. Workspaces now include .env.swarmclaw plus SwarmClaw, portable task/workspace, and AGENT_HOME env hints without embedding secrets.
Operations Pulse triage. Gateway actions now surface zero-available-environment states as high-priority operator work.

v1.9.3 Highlights

Bundled extension-orchestration release: managed plugin resources, gateway/setup declarations, and safer local folder access in one release cycle.

Managed extension resources. Extensions can now declare provisionable agents, schedules/routines, local folders, gateway platforms, and setup checks through managedResources or top-level manifest aliases.
Deterministic reconciliation. /api/extensions/managed-resources can preview and reconcile extension-owned agents and routines with stable IDs and managedByExtension markers.
Trusted local folders. Extension-declared local folders support root-bounded inspection and recursive listing with traversal and symlink-escape protection.
Operator UI. The Extensions screen now shows managed-resource badges and a Managed tab with totals plus per-extension reconcile controls.
Extension authoring spec. extension_creator now documents managed resources, gateway declarations, setup checks, and manifest aliases.

v1.9.2 Highlights

Bundled runtime-polish release: reasoning hygiene, deterministic delegation routing, task workflow polish, OpenClaw export hardening, and timeout hygiene.

Stateful reasoning tag scrubber. String-streamed <think>, <thinking>, <reasoning>, <thought>, and <REASONING_SCRATCHPAD> blocks are removed across split deltas and routed into SwarmClaw's thinking stream instead of leaking into visible answers.
Deterministic delegation profiles. manage_tasks now accepts explicit workType and requiredCapabilities routing hints, returns a stable routeKey, and can auto-assign unowned work without a classifier call when the profile is explicit.
Assignment workflow transitions. Newly assigned backlog/triage/todo tasks move into the in_progress workflow lane without changing their runtime status or queueing execution.
Knowledge hygiene pruning. Archived or superseded knowledge sources can now be pruned after a retention window, with prune actions recorded in the hygiene summary.
Collision-safe exports and timeout hardening. Portability exports support timestamped attachment filenames, the sandbox browser image build has a configurable timeout, and release notes now carry the macOS quarantine workaround for ad-hoc signed desktop builds.

v1.9.1 Highlights

Task execution workspace release: task-scoped workspaces, preview handoffs, and liveness evidence.

Task-scoped execution workspaces. Tasks can now provision a deterministic workspace under the SwarmClaw workspace root, preserving source cwd and project context while creating a task-local README for artifacts and handoffs.
Preview and runtime metadata. Tasks can carry preview links and runtime services, and the task board surfaces those links directly on task cards and sheets.
Liveness snapshots. Task list/read responses now compute blocked, queued, stale, retrying, ready, and terminal liveness states so operators can see why work is stopped or ready to run.
Browser smoke coverage. The browser smoke now creates a workspace-backed task and verifies the task board renders the workspace and liveness chips.

v1.8.13 Highlights

Task retry and host execute hotfix for issues #68 and #69.

Per-agent host execute. Agents configured with executeConfig.backend = "host" now pass that setting into the runtime execute tool, so persistent=true uses the documented host backend.
Scheduled task validation. Schedule-created tasks no longer get auto-classified as implementation tasks for quality gates unless they explicitly opt into a task quality gate.
Retry loop guard. A task that fails again with the same retry reason is dead-lettered instead of spending another run on identical work.

v1.8.12 Highlights

Gateway Fleet Command release: SwarmClaw now treats OpenClaw gateways as an operator surface instead of a background provider detail.

Fleet topology API. Added gateway topology endpoints that collect OpenClaw nodes, node pairings, device pairings, sessions, presence, and best-effort RPC errors in one server-side snapshot.
Provider console controls. The Providers screen can refresh a whole gateway fleet or a single gateway topology, showing sessions, presence, pending pairings, and topology warnings alongside deploy and runtime health.
Operations Pulse coverage. Degraded gateways, stale topology, failed topology refreshes, and pending OpenClaw pairings now appear in the shared operator triage queue.

v1.8.11 Highlights

DeepSeek tool-use hotfix for issue #67.

DeepSeek reasoning replay. Stored assistant turns now keep provider-native reasoning_content separately from visible text and send it back to DeepSeek on follow-up tool-use turns.
Streaming parity. Direct OpenAI-compatible streams and LangGraph agent streams both preserve reasoning_content while continuing to show reasoning through SwarmClaw's existing thinking surface.
Regression coverage. Added tests for DeepSeek history replay and the LangChain bridge selection path.

v1.8.1 Highlights

Operator evidence release: a focused follow-up that makes release and mission review easier to scan.

Operations Pulse. Home and Quality now share a live triage panel that rolls missions, runs, approvals, connector readiness, and budget pressure into one next-action queue.
Run Briefs. Run detail sheets now open with a deterministic brief: objective, owner, timeline, warnings, usage, and evidence before the raw replay log.
Evidence Shelf. Runs and missions now expose linked artifacts, task outputs, protocol outputs, mission reports, public share links, and knowledge citations through a shared artifact resolver.
Connector readiness. Connector cards now show credential, route, pairing, gateway, connection, and doctor hints so setup gaps are visible before a platform bridge is started.
API surface. Added GET /api/operations/pulse, GET /api/runs/:id/brief, and GET /api/artifacts for external operator dashboards and release tooling.

v1.8.0 Highlights

Mission Command release: a bigger operator update that makes autonomous missions easier to launch, inspect, and share.

Mission Command launchpad. The home launchpad now opens concrete mission starters for Release QA, Launch Sprint, Cost Audit, and Connector Smoke Test instead of dropping users into a generic mission list.
Deep-linked mission templates. /missions?template=<id> opens the right starter template directly, and the template installer can create a mission-driver chat when no sessions exist yet.
Quality Center handoffs. /quality?tab=evals|approvals|runs is shareable, and the Quality overview/Eval Lab can start a Release QA mission from current operator evidence.
Public mission reports. Missions can mint, copy, and revoke public share links from the detail view. Shared pages render status, budgets, milestones, and generated reports using the existing allowlisted share resolver.
Safer share payloads. Mission milestones now expose summary correctly in public HTML and raw markdown shares, with regression coverage in npm run test:runtime.

v1.7.3 Highlights

Desktop packaging fix for Linux AppImage and deb builds.

Linux desktop native modules match Electron. Packaged Linux builds now copy Electron-rebuilt native addons into the embedded Next standalone server, fixing the better-sqlite3 Node ABI mismatch reported in #65.
Desktop packaging regression coverage. The Electron afterPack hook now has a Linux standalone native-module sync test wired into npm run test:cli.
macOS desktop note. macOS builds remain ad-hoc signed and not notarized in this release, so the existing Gatekeeper/quarantine workaround still applies until Developer ID signing is available.

v1.7.2 Highlights

CLI provider usability follow-up for v1.7.0/v1.7.1. The expanded coding-agent roster is now easier to find, configure, and validate from onboarding and setup diagnostics.

Shared CLI provider registry. Bespoke and generic CLI providers now share one metadata source for display names, binary names, capabilities, setup defaults, and provider-set behavior, reducing drift across onboarding, runtime routing, setup doctor, and capability prompts.
Onboarding exposes the full CLI roster. The setup wizard groups providers by CLI agents, gateways/local runtimes, API providers, and custom endpoints, with search so the 31 extended CLI providers added in v1.7 are usable without digging through settings.
Connection checks for every CLI provider. Bespoke CLIs keep auth-aware checks, while generic CLIs verify that the expected binary is on PATH and return actionable install guidance when missing.
Update banner polish. Source installs now show the target stable tag/version, remember dismissal per release target, and make the required restart after update explicit.
macOS desktop note. macOS builds remain ad-hoc signed and not notarized in this release, so the existing Gatekeeper/quarantine workaround still applies until Developer ID signing is available.

v1.7.1 Highlights

Republish of v1.7.0 from the correct commit. The v1.7.0 tarball on npm was inadvertently published from a pre-rebase tree that did not include the v1.6.1 codex continuity fixes (PR #62) or the v1.6.2 plan doc. v1.7.1 ships the same coding-agent-roster expansion on top of the correct v1.6.1+ history.

Use v1.7.1 instead of v1.7.0; v1.7.0 has been deprecated on npm.

v1.7.0 Highlights

Extended CLI provider roster — every coding agent recognized by SwarmSkills now has a corresponding CLI provider in SwarmClaw, routed through a generic streamer when no bespoke parser exists.

31 new CLI providers. Aider, Amp, Augment, AdaL, IBM Bob, Cline, CodeBuddy, Command Code, Continue, Cortex Code, Crush, Deep Agents, Firebender, iFlow, Junie, Kilo Code, Kimi, Kode, MCPJam, Mistral Vibe, Mux, Neovate, OpenHands, Pochi, Qoder, Replit Agent, Roo Code, TRAE CN, Warp Agent, Windsurf, and Zencoder are now first-class provider IDs in ProviderType.
Generic CLI streamer. New streamGenericCliChat (src/lib/providers/generic-cli.ts) spawns the configured binary with the prompt as final argv and emits stdout lines as SSE deltas. Used by the new providers when no bespoke parser is available; existing bespoke parsers (Claude, Codex, Cursor, Gemini, Copilot, Droid, Qwen, OpenCode, Goose) are untouched.
Capability metadata. CLI_PROVIDER_CAPABILITIES (src/lib/providers/cli-utils.ts) carries a one-line description for each new provider so the UI and isCliProvider() recognize them.
Tests. New generic-cli.test.ts exercises the streamer against echo and asserts the missing-binary error path; cli-utils.test.ts extends the CLI provider recognition coverage.

v1.6.1 Highlights

Follow-up release for v1.6 with workflow starts, safer metadata handling, A2A discovery polish, and #61 by @latentwill. Thanks latentwill!

Mission and protocol templates for real work. New starter paths cover codebase review sprints, research bureau scans, content studio cycles, release readiness panels, synthesis panels, and builder review loops.
Home launchpad paths. First-run users can choose a self-hosted assistant, visual workflow, or autonomous mission path, with quality actions still one click away.
A2A discovery is easier to integrate. The canonical /.well-known/agent-card.json endpoint now works alongside the legacy API route and hides disabled or trashed agents from public discovery.
Internal metadata stripping is safer. Side-channel JSON is removed with balanced-object parsing and zod validation so nested payloads are scrubbed without deleting ordinary user JSON.
Browser smoke gate restored. npm run test:e2e now runs a Playwright smoke against health, A2A discovery, /home, and /quality, either against a live URL or a temporary local dev server.
OpenCode CLI hang fixed. OpenCode CLI delegation no longer keeps an inherited stdin pipe open, preventing hangs in non-interactive runs.

v1.6.0 Highlights

Operator Quality Center release for builders running autonomous agents in production-like workflows.

New Quality workspace. /quality brings run health, failed/running counts, pending approvals, latest eval scores, and attention shortcuts into one operator surface.
Eval Lab and Approval Desk. Existing eval and approval APIs are now exposed through a practical UI for running scenarios/suites, reviewing score evidence, and approving or denying human-loop/tool/connector/skill requests.
Run Review upgrades. The run history now has source filtering and search across run id, source, errors, results, and ownership fields while keeping the existing replay/evidence sheet.
Release-ready mission templates. New templates cover Release Candidate QA, Agent Cost Audit, Connector Smoke Test, Failed Run Triage, and Weekly Agent Quality Report using the existing mission budget/report model.
Home launchpad quality actions. First-run users can jump straight to evals, approvals, failed runs, and release QA missions from the operational launchpad.

v1.5.71 Highlights

Fast-follow release for #60 by @borislavnnikolov. Thanks Borislav!

Browser MCP works from standalone builds again. The Next standalone output now includes the Playwright MCP runtime packages required by packaged SwarmClaw builds.
Host browser launches use cached Chromium. Local Playwright MCP startup now selects Chromium explicitly instead of depending on a system Chrome install.
Standalone repair is more robust. The build repair step now fills partially traced Playwright MCP package directories, and the packaging and browser startup paths are covered by regression tests.

v1.5.70 Highlights

Fast-follow release for #56 by @latentwill. Thanks latentwill!

Also includes fixes for #57 and #58 reported by @zantak. Thanks zantak!

Builtin provider saves work again. Saving a builtin provider no longer sends the strict-schema rejected type field, and the provider update route is now covered by the runtime test script.
Knowledge sources appear on direct visits. Panel-backed routes such as Knowledge now auto-open their source/sidebar panel on desktop route changes, while mobile keeps the drawer closed by default.
Reasoning content stays out of the reply body. OpenAI-compatible reasoning_content and reasoning stream deltas now flow into the existing collapsed Thinking panel instead of being appended before the visible answer.
macOS install guidance remains explicit. Ad-hoc signed macOS desktop builds still document the quarantine workaround until Developer ID signing and notarization are available. Thanks @yagudaev for confirming the current workaround on Apple Silicon.

v1.5.69 Highlights

Fast-follow release for #55 by @borislavnnikolov. Thanks Borislav!

Structured runs are easier to find. Schedule-backed protocol runs now appear in the schedule console and unified /api/runs endpoints, including detail and event fallbacks for structured run records.
Agent sessions get a cleaner fresh-chat flow. Agent chat headers now expose a New chat action for sessions with history or saved CLI/runtime handles, first prompts derive compact session titles, and agent session lists sort newest-first.
Structured session execution is sturdier. CLI providers can execute structured turns through their direct provider runtime, blank structured responses now surface the real logged error where possible, successful structured turns clear their watchdog timers promptly, schedule timing changes recompute nextRunAt, and in-process daemon status/control paths are covered.
Package contents are safer. The npm package allowlist now explicitly excludes local env files under src/ even when a maintainer has private ignored config in their working tree.

v1.5.68 Highlights

Launch-readiness release for turning SwarmClaw's own next launch into a reusable workflow.

Launch Week Growth Sprint mission template. The mission template gallery now includes a launch-week operator that audits the product/docs, drafts GitHub Release, Product Hunt, Show HN, social, and community copy, identifies the top demo moments, and produces daily feedback/metrics/follow-up reports. The default goal explicitly keeps public posting behind approval.
Security and release metadata refresh. Next.js is updated to 16.2.4 in the app and docs site, OpenClaw / Discord.js / selected transitives are refreshed so the production high/critical audit gate passes, and the stale package-lock.json root version is realigned with the published package version.
Desktop release gate hardening. npm run electron:build now restores host-architecture native modules after macOS multi-arch packaging, so a local release smoke build no longer leaves the checkout unable to run the next host build.
Launch assets and docs. Added a concrete v1.5.68 launch plan in docs/release/v1.5.68-launch-plan.md, refreshed the website release notes/docs index, and updated stale install examples so public launch traffic sees current instructions.

v1.5.67 Highlights

Three chatroom-focused fixes from a community contribution by @borislavnnikolov. Thanks Borislav!

Inspect a chatroom member mid-turn. Clicking a member avatar in a chatroom while that agent is busy now opens a bottom sheet with the agent's synthetic chatroom session: recent messages, execution-log entries, and counts. Previously the click jumped to the agent detail page, which lost the chatroom context. The synthetic session-id convention (chatroom-<roomId>-<agentId>) is now centralized in src/lib/chatroom-sessions.ts and shared between the UI and chatroom-helpers.ts so the two halves can never drift.
Continue a specific session, not just the agent's main thread. The store now exposes an activeSessionIdOverride on the session slice. Selecting a chat from the Chat List or a specific session row from the Agent Inspector sets the override, so the chat surface opens that exact session instead of the agent's primary thread session. The override clears automatically when the agent changes or the session is removed, with regression tests in session-slice.test.ts covering the override-preferred, override-stale, and fallback cases.
Caret stays aligned with mention highlights in the chatroom composer. The mention-highlight <span> had px-0.5 padding that pushed the mirrored caret out of position at line ends. Padding is removed and the soft-accent background lightened slightly so the highlight still reads without nudging the layout.

v1.5.66 Highlights

Fixes a runaway-token-burn bug in the orchestrator-wake and heartbeat loops. The root cause was hidden in the success/failure classification: a session run can resolve its promise successfully while still carrying an error on the result (e.g. a provider 429 swallowed into persisted output), and the wake trackers only incremented their failure counters on a rejected promise. So the backoff never engaged, the auto-disable-after-N-failures gate never tripped, and the wake kept firing at its configured interval indefinitely — every firing spending tokens on a full prompt against a provider that was already cooling down.

classifyWakeOutcome (src/lib/server/runtime/heartbeat-service.ts) — new pure helper, extracted for unit testing, that maps a resolved run result into null (success) or a short failure reason. A run counts as a failure when result.error is a non-empty string, or when result.text is empty/whitespace-only. Both the orchestrator-wake and heartbeat outcome handlers now feed through this helper, so silent-failure runs tick the failure counter and the exponential backoff (10s → 5min) kicks in normally.
Auto-disable gate now trips for provider 429 / silent-wake loops. The existing MAX_CONSECUTIVE_FAILURES = 10 threshold was already in place but unreachable for the most common failure mode (429 errors that still persisted a run). After the fix, ten consecutive dud wakes auto-disable the orchestrator/heartbeat for that agent/session and post an explicit notification instead of grinding indefinitely.
Regression coverage. heartbeat-service.test.ts now has 5 targeted cases on classifyWakeOutcome — the 429 regression, empty-output detection, non-string error fields, whitespace-only errors, and the happy path. test:runtime now runs 104 cases.

v1.5.65 Highlights

Follow-up hardening on the v1.5.64 work after live-testing the chat-header flows, the MCP connection pool, and the MCP Registry browser. Six concrete bugs fixed in the clear/undo, MCP pool eviction, and registry-browser code paths.

clearChatMessages now resets opencodeWebSessionId too. The snapshot/undo pair already captured and restored it, but clear itself left the stale identifier in place — so a fresh opencode-web turn would resume the conversation the user intended to drop. Paired with a matching default in storage-normalization.ts so older session records load with opencodeWebSessionId: null instead of undefined. Regression covered by clear-route.test.ts.
Undo toast no longer writes to the wrong chat. If the user navigated away after clicking Clear, clicking Undo in the toast would inject restored messages into whatever chat was currently open. chat-area.tsx now gates the setMessages calls on selectActiveSessionId === targetSessionId; same guard added to the compact-complete path.
Background MCP status probes no longer evict the connection pool. Visiting /mcp-servers auto-called POST /api/mcp-servers/:id/test for every server, which force-disconnected pooled clients that running agents were using mid-turn. Eviction is now gated behind ?reset=1, which only the explicit Re-test button sends. Regression added to src/app/api/mcp-servers/route.test.ts.
SwarmDock MCP Registry browser actually works now. The upstream swarmdock-api.onrender.com endpoint emits no CORS headers, so the in-browser RegistryBrowser component always failed with Failed to fetch. Added GET /api/mcp-registry and GET /api/mcp-registry/:slug as server-side proxies and rewired the component to call them. Verified in Chrome: 20 servers load, selecting one prefills the New MCP Server sheet with its recommended install command.
mcp-registry CLI group. New commands swarmclaw mcp-registry search and swarmclaw mcp-registry get <slug> so CLI workflows can pull from the same proxy.
Prior release's MCP tool-evict-on-transport-failure fix (cherry-picked from user's local branch): connection-class errors from downstream MCP tools now evict the pool entry for the originating server, so the next turn reconnects fresh instead of retrying through a half-broken transport.

v1.5.64 Highlights

Two themes this release. First, context-window management reaches the chat UI: a live token-usage meter in every chat header, a one-click LLM-backed compaction that keeps the session alive without nuking history, and a redesigned clear flow with a 30-second undo that restores both transcripts and CLI resume IDs. Second, MCP token spend is now controllable: per-server alwaysExpose policy, per-agent eager-tool overrides, an in-session mcp_tool_search promoter, a long-lived connection pool, a token-cost endpoint per server, and a built-in browser for the public SwarmDock MCP registry.

Context meter in the chat header. New ContextMeterBadge (src/components/chat/context-meter-badge.tsx) renders a live chip showing N% · Mk next to the chat title, driven by GET /api/chats/:id/context-status. Color thresholds at 70% (amber) and 90% (red). Clicking the chip opens a popover with the full breakdown (used / remaining / messages) plus Compact and Clear buttons. The button row explicitly states: "Long-term memory, skills, and facts are preserved. Clear only affects this chat transcript." — so users stop fearing Clear.
User-invokable /compact via the popover. New POST /api/chats/:id/compact runs summarizeAndCompact with the session's own provider/model via buildChatModel as the summarizer. The existing hierarchical-summary pipeline in context-manager.ts does the work: tool failures, file ops, and adaptive chunking are all preserved. Accepts keepLastN in the body (2-200, default 10). Returns status: 'no_action' | 'compacted' plus counts. The popover gates the button below 3 messages so users don't waste LLM calls on trivially short transcripts.
Clear with 30-second undo. POST /api/chats/:id/clear now returns { cleared, undoToken, expiresAt }, and a new POST /api/chats/:id/clear/undo restores the snapshot. The undo snapshot (messages + every CLI session ID including claudeSessionId, codexThreadId, opencodeSessionId, opencodeWebSessionId, geminiSessionId, copilotSessionId, droidSessionId, cursorSessionId, qwenSessionId, acpSessionId, and delegateResumeIds) lives in an HMR-safe in-memory store (src/lib/server/chats/clear-undo-snapshots.ts) with a 30-second TTL, 200-entry cap, session-scoped lookups, and single-use tokens. The chat UI wires this to a sonner toast with an Undo action; restoring fires a "Chat restored." confirmation toast.
alwaysExpose policy for MCP servers (McpServerConfig.alwaysExpose: boolean | string[], default true for back-compat). Set false on a chatty server (e.g. a Playwright MCP with 40 tools that cost thousands of tokens per turn) and the agent binds nothing up front — it can still discover and promote specific tools via the new mcp_tool_search meta-tool. Set an allowlist ['query_resources', 'fetch_url'] to eagerly bind a curated subset.
Per-agent mcpEagerTools override (Agent.mcpEagerTools?: string[]) lets you force-expose specific tool names for a specific agent regardless of the server's alwaysExpose. Precedence: per-agent allowlist > server alwaysExpose > session promotions.
mcp_tool_search meta-tool (src/lib/server/mcp-gateway-runtime.ts). When a server's tools are lazy, the agent gets a single mcp_tool_search({ query, limit? }) tool that searches the process-wide discovery cache (bare name substring + description keywords) and promotes matches for the current session. The next turn binds the promoted names for real. SessionToolPromoter state is keyed by session ID and HMR-safe. Behavior mirrors @swarmclawai/mcp-gateway's router so users who split MCP fan-out across SwarmClaw and the gateway get consistent semantics.
Long-lived MCP connection pool (src/lib/server/mcp-connection-pool.ts). A single client/transport per server lives for the process lifetime instead of reconnecting every turn. Config-fingerprint tracking rotates stale entries automatically; the /test endpoint evicts explicitly so a config change takes effect immediately. Saves ~100-500ms × (servers × turns) per chat. HMR-safe via hmrSingleton so dev reloads don't leak child processes.
Token-cost discovery endpoint (GET /api/mcp-servers/:id/tools-info). Connects, lists tools, and reports per-tool schema tokens plus aggregates — using the same chars / 3.5 formula as @swarmclawai/mcp-gateway so numbers line up side by side. Surfaces inside mcp-server-list.tsx so you can see which server is the costliest before an agent even runs.
SwarmDock MCP Registry browser (src/components/mcp-servers/registry-browser.tsx). Opens from the New MCP Server sheet and browses the public registry at https://swarmdock-api.onrender.com/api/v1/mcp/servers. Selecting a server populates the form with its recommended install command — one-click discovery without leaving SwarmClaw. A new MCP Gateway (local) preset is also bundled so users can bootstrap @swarmclawai/mcp-gateway in one tap.
4 new CLI commands. swarmclaw chats context-status <id>, swarmclaw chats compact <id>, swarmclaw chats clear-undo <id>, and the existing chats clear now returns the undo token so CLI scripts can build their own clear+undo workflows.
Back-compat normalization. Existing MCP servers load with alwaysExpose: true (historical behavior — every tool bound every turn) via storage-normalization.ts. No user action required to upgrade.
Full regression coverage. New tests: clear-undo-snapshots.test.ts (5 cases — TTL, single-use, session isolation, CLI-id preservation, expiry sweep), clear-route.test.ts (clear → undo → double-undo 404 → missing-session 404 round-trip), compact-route.test.ts (no-action path + 404), context-status-route.test.ts, plus mcp-connection-pool.test.ts and mcp-gateway-runtime.test.ts. test:runtime runs 100 tests across 13 suites.

v1.5.63 Highlights

Chatroom fix from @borislavnnikolov: CLI-backed agents (codex-cli, copilot-cli, gemini-cli, and the rest of the NON_LANGGRAPH_PROVIDER_IDS set) now work correctly as chatroom members instead of falling through a LangGraph path they cannot run. With the execution path fixed, the worker-only membership blocks are lifted too, so any non-trashed agent can be added to a room.

Direct provider runtime for CLI chatroom turns. src/app/api/chatrooms/[id]/chat/route.ts now branches on NON_LANGGRAPH_PROVIDER_IDS and calls provider.handler.streamChat() directly for CLI-backed agents while keeping the LangGraph streamAgentChat path for everything else. Streaming, tool events, and persisted messages all flow through unchanged.
Full member selection. The create, update, members, session-tool, and UI layers (src/app/api/chatrooms/route.ts, src/app/api/chatrooms/[id]/route.ts, src/app/api/chatrooms/[id]/members/route.ts, src/lib/server/session-tools/chatroom.ts, src/components/chatrooms/chatroom-sheet.tsx) no longer reject or hide worker-only agents. Any non-trashed agent is eligible.
Regression test. src/app/api/chatrooms/[id]/chat/route.test.ts proves a codex-cli-backed chatroom turn bypasses streamAgentChat, streams a response through the provider handler, and persists one assistant reply.

v1.5.62 Highlights

Hardens parallel sub-agent dispatch with a concurrency cap, a quorum join policy, and a cycle check — so a fan-out can't accidentally saturate providers, melt a mission budget, or wedge the runtime on a delegation loop.

spawn_subagent swarm/batch actions now accept maxConcurrency, joinPolicy, quorum, and cancelRemaining. Parallel mode fans out at most 4 branches at a time by default (hard-capped at 16). Task buckets share an executionGroupKey so the existing per-execution serial lock enforces the cap with zero new scheduler code. joinPolicy: 'quorum' resolves once quorum branches succeed and (by default) cancels the remaining in-flight branches. joinPolicy: 'first' resolves on the first success. joinPolicy: 'all' stays the default.
Cycle detection in spawnSubagent. Before creating a child session, the runtime walks the parentSessionId ancestry and rejects the spawn when the requested agentId already appears higher in the chain. Clear error message with an allowCycle: true escape hatch. Orthogonal to the existing depth cap.
Per-agent and per-mission overrides. Agent.maxParallelDelegations and MissionBudget.maxParallelBranches plumb into the swarm resolver. Precedence: explicit tool arg > agent cap > mission cap > system default (4). Both are validated by AgentUpdateSchema and the mission budget schemas, and normalized on load via storage-normalization.ts.
Swarm snapshot exposes the effective cap. SwarmSnapshot.maxConcurrency lands in the persisted snapshot payload so the UI and external tooling can surface the active concurrency level. Verified live via a 3-branch quorum run: totalCompleted: 2, totalCancelled: 1, maxConcurrency: 2, joinPolicy: "quorum".

v1.5.61 Highlights

Adds an opt-in per-agent planning mode that rides on the existing [MAIN_LOOP_PLAN] token machinery.

Agent.planningMode: 'off' | 'strict' | null — new optional field on the Agent type. Defaults to null (off) so existing agents are unaffected. Validated by AgentCreateSchema / AgentUpdateSchema and surfaced through createAgent in agent-service.ts.
Strict planning prompt section. New buildPlanningModeSection in prompt-sections.ts injects a short contract into the system prompt when planningMode === 'strict': before any multi-step work, emit a single-line [MAIN_LOOP_PLAN]{"steps":...} block. The existing parser in main-agent-loop.ts reads these blocks into MainLoopState.planSteps / currentPlanStep / completedPlanSteps with no additional wiring. Skipped in minimal prompt mode and for heartbeat turns.
Test coverage. prompt-sections.planning-mode.test.ts covers the null / off / strict / minimal / missing-agent paths (6 cases).

v1.5.60 Highlights

Adds a turn-snapshot primitive for external replay and comparison tooling, without touching the execution flow.

Turn snapshot endpoint. New GET /api/chats/:id/turns/:index/snapshot returns the input state of a prior user turn: the message (text + optional imagePath + time), all prior messages in order, the session's effective provider/model/endpoint/credential at snapshot time, and the bound agent's provider/model/systemPrompt when available. Invalid or non-user indices return 400, out-of-range indices return 404. CLI: swarmclaw chats turn-snapshot <chatId> <index>.
Use case. External CLIs, notebooks, and comparison harnesses can now capture the exact inputs that produced a given turn and replay them against a different model, provider, or system prompt to compare outputs — without mutating the original session. Pairs with the existing edit-resend path (destructive in-session replay) and the new share-link infrastructure in v1.5.59 (share the original turn's context, replay on another instance).

v1.5.59 Highlights

Viral-loop release. Adds public share links for missions, skills, and sessions, plus a complementary raw-markdown endpoint so any shared skill installs directly through the existing POST /api/skills/import.

Share links for missions, skills, and sessions. New share_links collection in src/lib/server/storage.ts plus src/lib/server/sharing/share-link-repository.ts. POST /api/share { entityType, entityId, expiresInSec?, label? } mints a cryptographically random 32-char base64url token; GET /api/share lists; GET /api/share/:id fetches; DELETE /api/share/:id revokes (pass ?hard=true to hard-delete). CLI: swarmclaw share {list,mint,get,revoke,resolve,raw}.
Public read endpoints (no auth required). GET /api/s/:token returns the scrubbed JSON payload; GET /api/s/:token/raw returns plain markdown (skills return their SKILL.md verbatim, missions render as title + goal + criteria + milestones, sessions as a transcript). Revoked and expired tokens return 404 Not found without leaking shape information. GET /s/:token is a server-rendered page for dropping straight into a browser.
Share-link-based skill install. POST /api/skills/import already accepts an http(s) URL; pointing it at https://<your-host>/api/s/<token>/raw now installs a shared skill from another SwarmClaw instance without auth handshakes. Pairs naturally with existing swarmclaw skills import CLI.
Share-link repository tests. share-link-repository.test.ts covers mint / list / revoke / lookup-by-token round-trip plus expiry handling against a temporary data dir.

Older releases: https://swarmclaw.ai/docs/release-notes

GitHub releases: https://github.com/swarmclawai/swarmclaw/releases
npm package: https://www.npmjs.com/package/@swarmclawai/swarmclaw
Historical release notes: https://swarmclaw.ai/docs/release-notes

FAQ

General

What is SwarmClaw? SwarmClaw is an open-source, self-hosted AI agent runtime and multi-agent framework. It lets you run autonomous AI agents, agent swarms, and orchestrators with durable memory, MCP tools, skills, delegation, schedules, and support for 23+ LLM providers — serving as a practical alternative to Claude Code and LangChain for self-hosted workflows.

How does SwarmClaw differ from LangChain or CrewAI? SwarmClaw is a self-hosted runtime rather than a code library. It provides a persistent dashboard, durable agent memory, real-time org chart visualization, and built-in multi-agent orchestration with delegation — all running on your own infrastructure. LangChain and CrewAI are code frameworks you embed in your applications; SwarmClaw is the platform your agents run on.

Is SwarmClaw production-ready? Yes. SwarmClaw is used in production by teams running autonomous agent swarms. It includes security features like approval-gated actions, TLS support, and access key management.

Setup & Configuration

How do I install SwarmClaw? Install via npm: npm install -g @swarmclawai/swarmclaw, then run swarmclaw init to create your configuration. Docker deployment is also available via the provided Docker Compose setup.

Which LLM providers are supported? SwarmClaw supports 23+ providers including OpenAI, Anthropic (Claude), Google Gemini, OpenRouter, Ollama (local), DeepSeek, Groq, Together AI, and more. Configure your API keys in the .env file or via the dashboard.

Can I use local models? Yes. SwarmClaw integrates with Ollama and other local LLM backends for fully offline agent operation.

Agent Development

What is an agent swarm? An agent swarm is a group of AI agents working together under an orchestrator. Each agent has its own role, tools, and memory. The orchestrator delegates tasks, agents execute in parallel, and results are aggregated — mimicking a real organizational structure.

What are MCP tools? MCP (Model Context Protocol) tools let agents interact with external systems — databases, APIs, file systems, browsers, and more. SwarmClaw provides a marketplace of pre-built MCP tools at SwarmDock.

How does agent memory work? SwarmClaw provides durable agent memory that persists across sessions. Each agent maintains its own conversation history, learned skills, and context — enabling long-running autonomous workflows.

Deployment

How do I deploy SwarmClaw? Options include: local npm installation, Docker Compose for containerized deployment, or cloud VPS with reverse proxy and TLS. See the deployment docs for detailed guides.

Can I run SwarmClaw in the cloud? Yes. SwarmClaw runs on any Linux server with Node.js 18+. Popular options include AWS EC2, DigitalOcean, Hetzner, and self-hosted on home servers.

Troubleshooting

Agent is not responding. What should I check? Verify your LLM API key is valid, check the agent's configuration in the dashboard, and review the agent chat logs for error messages. Common issues include rate limiting and invalid model names.

How do I update SwarmClaw? Run npm update -g @swarmclawai/swarmclaw or pull the latest Docker image. Check the release notes for breaking changes.

Where can I get help?

Documentation: https://swarmclaw.ai/docs
Discord community: https://discord.gg/sbEavS8cPV
GitHub Issues: https://github.com/swarmclawai/swarmclaw/issues

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
SwarmDock: https://swarmclaw.ai/docs/swarmdock
SwarmDock marketplace: https://swarmdock.ai
SwarmFeed: https://swarmclaw.ai/docs/swarmfeed
SwarmFeed platform: https://swarmfeed.ai
SwarmVault: https://swarmvault.ai
Extensions: https://swarmclaw.ai/docs/extensions
CLI reference: https://swarmclaw.ai/docs/cli

Name		Name	Last commit message	Last commit date
Latest commit History 468 Commits
.github/workflows		.github/workflows
bin		bin
data		data
doc/assets		doc/assets
docs/release		docs/release
electron		electron
public		public
resources		resources
scripts		scripts
skills		skills
src		src
swarmclaw		swarmclaw
tests		tests
.dockerignore		.dockerignore
.eslint-baseline.json		.eslint-baseline.json
.gitignore		.gitignore
.npmignore		.npmignore
.nvmrc		.nvmrc
CLAUDE.md		CLAUDE.md
CONTRIBUTING.md		CONTRIBUTING.md
Dockerfile		Dockerfile
Dockerfile.sandbox-browser		Dockerfile.sandbox-browser
LICENSE		LICENSE
README.md		README.md
SWARMDOCK.md		SWARMDOCK.md
components.json		components.json
docker-compose.yml		docker-compose.yml
electron-builder.yml		electron-builder.yml
eslint.config.mjs		eslint.config.mjs
fly.toml		fly.toml
install.sh		install.sh
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
railway.json		railway.json
render.yaml		render.yaml
research.md		research.md
swarmclaw-skill.md		swarmclaw-skill.md
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

SwarmClaw

Screenshots

Requirements

Quick Start

Desktop app (recommended for non-technical users)

Global install

From the repo

Docker

ClawHub Skill

v1.9.25 Highlights

Hosted Deploys

Core Capabilities

What SwarmClaw Focuses On

OpenClaw

Use Cases

Personal Assistant

Virtual Company

Development Team

Research Bureau

OpenClaw Fleet

Content Studio

Customer Support Desk

Crypto Operations

Mix and Match

Skill Drafts From Conversations

SwarmDock Marketplace

SwarmFeed Social Network

OpenTelemetry OTLP Export

Releases

v1.9.25 Highlights

v1.9.23 Highlights

v1.9.22 Highlights

v1.9.21 Highlights

v1.9.20 Highlights

v1.9.19 Highlights

v1.9.18 Highlights

v1.9.17 Highlights

v1.9.16 Highlights

v1.9.15 Highlights

v1.9.14 Highlights

v1.9.13 Highlights

v1.9.12 Highlights

v1.9.11 Highlights

v1.9.10 Highlights

v1.9.9 Highlights

v1.9.8 Highlights

v1.9.7 Highlights

v1.9.6 Highlights

v1.9.5 Highlights

v1.9.4 Highlights

v1.9.3 Highlights

v1.9.2 Highlights

v1.9.1 Highlights

v1.8.13 Highlights

v1.8.12 Highlights

v1.8.11 Highlights

v1.8.1 Highlights

v1.8.0 Highlights

v1.7.3 Highlights

v1.7.2 Highlights

v1.7.1 Highlights

v1.7.0 Highlights

v1.6.1 Highlights

v1.6.0 Highlights

v1.5.71 Highlights

v1.5.70 Highlights

v1.5.69 Highlights

v1.5.68 Highlights

v1.5.67 Highlights

v1.5.66 Highlights

v1.5.65 Highlights

v1.5.64 Highlights

v1.5.63 Highlights

v1.5.62 Highlights

v1.5.61 Highlights

v1.5.60 Highlights

Packages