bot-wake

Check a bot's heartbeat and redeploy it if unhealthy.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Wake a specific bot on demand. This skill checks the bot's heartbeat and only redeploys if the heartbeat indicates the bot is unhealthy, reducing unnecessary restarts.

Core Features & Use Cases

  • Heartbeat-aware wake: queries the bot's /api/heartbeat before taking action
  • Safe redeploy: delegates to the bot-redeploy workflow only when needed
  • Simple maintenance: supports waking named bots across the peer network

Quick Start

Execute the wake.sh script with the target bot name to wake a bot.

Frequently Asked Questions about bot-wake

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

FAQPage Schema
How do I wake a bot on demand after checking its heartbeat status?

To wake a bot on demand, the skill queries the bot's /api/heartbeat endpoint and only triggers a redeploy if the health check indicates the bot is unhealthy. It locates the bot URL via the peers API to perform the targeted wake action.

What do I need to check bot heartbeat status and trigger a redeploy?

Checking bot heartbeat status and redeploying requires the bot-redeploy script, access to the peers API to locate bot URLs, and the command-line tools jq and curl installed in your environment.

Can I wake a specific named bot across a peer network?

Yes, you can wake specific named bots across the peer network by passing the target bot name as an argument to the wake.sh script, which validates the input before initiating the heartbeat check.

Why does my bot wake action skip the redeploy step?

A bot wake action skips redeployment when the /api/heartbeat health check returns a healthy status, preventing unnecessary restarts and reducing downtime for bots that are already running normally.

Is there a way to automate bot maintenance and avoid unnecessary restarts?

Yes, automating bot maintenance with a heartbeat-aware wake script avoids unnecessary restarts by delegating to the bot-redeploy workflow only when the health check fails, keeping stable bots running without interruption.

What are the limitations of using curl and jq for bot heartbeat monitoring?

Using curl and jq for bot heartbeat monitoring limits you to querying HTTP endpoints and parsing JSON responses, requiring a valid /api/heartbeat endpoint on the target bot and manual integration with the peers API for network-wide operations.