fleet-check

Queries the ClawNet peers API and probes heartbeat endpoints to produce a JSON health summary.

1|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/b-open-io/clawnet-bot --skill fleet-check-b-open-io
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fleet-check
Source: https://github.com/b-open-io/clawnet-bot/tree/main/.agents/johnny/skills/fleet-check
Command: npx skills add https://github.com/b-open-io/clawnet-bot --skill fleet-check-b-open-io

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, curl, and includes scripts (resource) components.

What problem does it solve?

Quickly determine the health of deployed ClawNet bots by querying the ClawNet peers API and probing each bot's heartbeat endpoint to detect outages and report fleet status.

Core Features & Use Cases

  • Fleet discovery: fetches running peers from the Peers API and builds a health summary.
  • Health probing: pings each bot's /api/heartbeat endpoint and aggregates results.
  • Output for automation: emits a JSON array with botName, url, healthy, and lastSeen for downstream tooling.

Quick Start

Run the health-check script to query peers and output the fleet health JSON report.

Frequently Asked Questions about fleet-check

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I monitor ClawNet bot fleet health across all running peers?

Monitor ClawNet bot fleet health by querying the Peers API to discover running bots and probing each bot's heartbeat endpoint. The script aggregates per-bot HTTP 200 responses and last seen times into a structured JSON summary.

What is the best way to check if a deployed bot's heartbeat endpoint is responding?

Checking a deployed bot's heartbeat endpoint involves probing its /api/heartbeat URL via curl. The script filters peers by running status and tests each endpoint, reporting whether it returns a healthy HTTP 200 response.

Can I use curl and jq to automate fleet health monitoring and output JSON?

Yes, you can automate fleet health monitoring using curl and jq dependencies. The script fetches peer data via curl, processes the JSON with jq to filter running bots, and outputs a structured JSON array for downstream automation tooling.

Does fleet-check work with the ClawNet peers API for detecting bot outages?

fleet-check works directly with the ClawNet peers API for outage detection. It fetches all running peers, probes their heartbeat endpoints, and reports unhealthy bots by emitting a JSON array with botName, url, healthy, and lastSeen fields.

What JSON format does the fleet health monitoring script produce for downstream tooling?

The fleet health monitoring script produces a JSON array containing objects with botName, url, healthy, and lastSeen fields. This structured output allows downstream automation tooling to parse and react to individual bot health statuses.

Why do I need to filter peers by status before probing heartbeat endpoints?

Filtering peers by status before probing heartbeat endpoints ensures the script only tests currently running bots. This deterministic scripting approach queries the Peers API, filters for active URLs, and reports HTTP 200 heartbeats exclusively for deployed peers.