← Back to Skills Marketplace
swarm-self-heal
by
Todd Kuehnl
· GitHub ↗
· v0.1.1
547
Downloads
0
Stars
3
Active Installs
2
Versions
Install in OpenClaw
/install swarm-self-heal
Description
Swarm reliability watchdog for OpenClaw — validates gateway/channel and every lane, performs bounded recovery, and emits auditable receipts.
Usage Guidance
This skill appears to implement the described watchdog behavior and uses only the OpenClaw CLI plus bash/jq, but review a few things before installing: 1) Inspect setup.sh and change/remove the hard-coded Telegram fallback '8563003761' (or ensure your $HOME/.openclaw/openclaw.json contains the correct channel target) to avoid sending alerts to an unexpected recipient. 2) Installing will copy scripts into ~/.openclaw/workspace-studio/scripts and register cron jobs that run autonomously and may restart the user-level openclaw-gateway service—make a backup of OpenClaw cron/jobs.json and openclaw.json first. 3) Run the scripts manually in a controlled environment (or review outputs from check.sh) to confirm behavior before enabling cron. If you want higher assurance, ask the author for an explanation of the fallback number or a configurable opt-in for external notifications.
Capability Analysis
Type: OpenClaw Skill
Name: swarm-self-heal
Version: 0.1.1
The 'swarm-self-heal' skill is designed to monitor and self-heal an OpenClaw agent swarm. It uses standard OpenClaw CLI commands, `bash`, and `jq` to perform health checks, restart the gateway if needed, and ping agents. Persistence is established via cron jobs in `scripts/setup.sh`, which is a core, stated feature for a watchdog. The skill utilizes prompt engineering in `scripts/setup.sh` to instruct the agent running the cron job to execute a local script and format its output, and in `scripts/swarm_self_heal.sh` to send benign 'ping' messages to other agents. While these are instances of prompt injection, they are used for the skill's stated purpose and show no evidence of malicious intent, data exfiltration, or unauthorized actions. All operations are aligned with system maintenance and reliability.
Capability Assessment
Purpose & Capability
Name/description align with the scripts: the files implement a passive-first swarm watchdog using the OpenClaw CLI, perform bounded recovery (gateway restart + re-probe), emit receipts, and set up cron lanes. Required binaries (bash, jq, openclaw) are appropriate.
Instruction Scope
Runtime instructions and scripts stay on task: they read OpenClaw status, call openclaw health/channels/agent commands, and install scripts into the OpenClaw workspace. They read $HOME/.openclaw/openclaw.json and cron/jobs.json (expected for cron wiring). One scope concern: setup.sh will create cron jobs that post messages via the OpenClaw Telegram channel—so telemetry/outputs will be sent externally via OpenClaw's channel if configured (see environment_proportionality).
Install Mechanism
No package download or remote install is performed by the registry metadata; the repo contains local shell scripts and the user-run setup.sh copies them into ~/.openclaw/workspace-studio/scripts and uses the OpenClaw CLI to register cron jobs. That is a low-risk, user-initiated install pattern, but it does write scripts into the user's OpenClaw workspace.
Credentials
The skill does not request extra credentials, but setup.sh falls back to a hard-coded Telegram recipient '8563003761' when it cannot derive a target from $HOME/.openclaw/openclaw.json. This means if the user's OpenClaw config lacks a telegram target, the skill will create cron jobs that send notifications to that number—potentially leaking incident output to an external party. The scripts also read OpenClaw config files (which may contain channel tokens) — this is expected for a notifier but should be acknowledged before installing.
Persistence & Privilege
The skill adds/edits OpenClaw cron jobs (primary and backup watchdog) so it becomes an autonomously-scheduled component via OpenClaw (normal for a watchdog). always:false, so it won't be force-included in all agents, but installing will create scheduled autonomous runs and restart the user-level openclaw-gateway service when needed. Users should be aware this gives the skill recurring execution via OpenClaw cron.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install swarm-self-heal - After installation, invoke the skill by name or use
/swarm-self-heal - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.1
Anvil AI rebrand + labs.anvil-ai.io normalization.
v0.1.0
Initial release. Swarm reliability watchdog with passive-first detection, bounded recovery, and auditable receipts.
Metadata
Frequently Asked Questions
What is swarm-self-heal?
Swarm reliability watchdog for OpenClaw — validates gateway/channel and every lane, performs bounded recovery, and emits auditable receipts. It is an AI Agent Skill for Claude Code / OpenClaw, with 547 downloads so far.
How do I install swarm-self-heal?
Run "/install swarm-self-heal" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is swarm-self-heal free?
Yes, swarm-self-heal is completely free (open-source). You can download, install and use it at no cost.
Which platforms does swarm-self-heal support?
swarm-self-heal is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created swarm-self-heal?
It is built and maintained by Todd Kuehnl (@tkuehnl); the current version is v0.1.1.
More Skills