Openclaw-master-skills swarmclaw

Overview

SwarmClaw is a self-hosted AI agent orchestration dashboard. This skill gives you CLI access to manage agents, tasks, sessions, schedules, and memory across a SwarmClaw instance.

Install the CLI:

npm i -g @swarmclawai/swarmclaw

Authentication uses

SWARMCLAW_ACCESS_KEY

(preferred) or CLI key flags. Default URL is

http://localhost:3456

; override with

SWARMCLAW_URL

,

--url

(legacy commands), or

--base-url

(API-mapped commands).

Use machine-readable output when parsing command results:

• --raw

  for legacy commands

• --json

  for API-mapped commands

Setup

1. Install:

   npm i -g @swarmclawai/swarmclaw

2. Set env var:

   export SWARMCLAW_ACCESS_KEY=<your-key>

   (shown in terminal on first run)
3. Full docs: https://swarmclaw.ai/docs — CLI reference: https://github.com/swarmclawai/swarmclaw

Multi-Gateway Fleet Management

SwarmClaw can connect to multiple OpenClaw gateways at the same time. Each SwarmClaw agent can target a different gateway, including one local and several remote instances. This skill’s commands operate through the SwarmClaw control plane, so your agent/task/session actions apply across the fleet view. Use it when you need status and task coordination across more than one OpenClaw instance.

Commands

Agents:

• swarmclaw agents list

  — list all agents with IDs, names, providers, status

swarmclaw agents list --raw

• swarmclaw agents get <agentId>

  — get full details for a specific agent

swarmclaw agents get <agentId> --raw

Tasks:

• swarmclaw tasks create --title "..." --description "..." --agent-id <agentId>

  — create and assign a task

swarmclaw tasks create --title "Analyse competitor pricing" --description "Research and compare competitor pricing strategies, identify gaps and opportunities" --agent-id <agentId> --raw

• swarmclaw tasks list

  — list all tasks with status

swarmclaw tasks list --raw

Sessions:

• swarmclaw sessions list

  — list active sessions

swarmclaw sessions list --raw

• swarmclaw sessions chat <id> --message "..."

  — send a message to an existing session

swarmclaw sessions chat <id> --message "Give me a status update" --raw

Memory:

• swarmclaw memory maintenance

  — run memory maintenance analysis

swarmclaw memory maintenance --raw

Diagnostics:

• swarmclaw setup doctor

  — run system diagnostics and report issues

swarmclaw setup doctor --raw

Version:

• swarmclaw version check

  — check current version and update status

swarmclaw version check --raw

Rules

1. Always verify an agent ID exists by running

   agents list

   before creating tasks for it.
2. Never pass the access key as a CLI argument in visible output — rely on the

   SWARMCLAW_ACCESS_KEY

   env var.
3. If the SwarmClaw instance is unreachable, run

   swarmclaw setup doctor

   and report the findings before retrying.
4. When the user says "dispatch work", "get X agent to do Y", or "assign this to", use

   tasks create

   to assign the work to the appropriate agent.
5. When the user asks "what's running", "agent status", or "what are my agents doing", combine output from

   agents list

   and

   sessions list

   to give a full picture.
6. For complex multi-step orchestration, create individual tasks rather than chaining commands.
7. Use

   --raw

   /

   --json

   output modes when you need to parse command output for further processing.
8. Do not run commands that modify or delete agents without explicit user confirmation.

Examples

Dispatch work to another agent: User says: "Get my research agent to analyse competitor pricing"

swarmclaw agents list --raw
swarmclaw tasks create --title "Analyse competitor pricing" --description "Research and compare competitor pricing strategies, identify gaps and opportunities" --agent-id <research-agent-id> --raw

Then confirm the task was created and the agent will pick it up.

Check fleet status: User says: "What are all my agents doing right now?"

swarmclaw agents list --raw
swarmclaw sessions list --raw

Then summarize which agents are idle, which have active sessions, and any tasks in progress.

Run diagnostics: User says: "Something seems wrong with SwarmClaw"

swarmclaw setup doctor --raw

Then report issues found and suggest fixes based on the doctor output.

Check agents across gateways: User says: "What's happening across all my OpenClaw instances?"

swarmclaw agents list --raw

Then use the output to identify agents across multiple gateways with their connection status, and summarize which gateways are healthy and which agents are active on each.