mcpField
H
hummingbot-heartbeat

hummingbot-heartbeat

github.com/hummingbotCloud & DevOps32355 installsUpdated 21w ago
Repository

About hummingbot-heartbeat

hummingbot-heartbeat is an OpenClaw cron skill that creates hourly Hummingbot status reports for a connected chat channel. It checks API health, Gateway, bots, executors, and portfolio balances.

Key features

  1. 01Hourly status reports
  2. 02API health check
  3. 03Gateway status check
  4. 04Bot and executor status
  5. 05Portfolio balance reporting

Use cases

  1. 01Send hourly Hummingbot updates to a chat channel
  2. 02Inspect API, Gateway, and bot status
  3. 03Review recent portfolio balances

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/hummingbot/skills --skill hummingbot-heartbeat

After installing, type/hummingbot-heartbeatin Claude Code to confirm it loaded.

Bundled files.env.examplescripts/bot_status.py

Details

From the project README

hummingbot-heartbeat

An OpenClaw cron skill that runs every hour and delivers a formatted Hummingbot status report to your connected chat channel (Telegram, Discord, etc.). Covers API health, Gateway container, active bots/controllers, executors, and portfolio balances.

Installation

clawhub install hummingbot-heartbeat

Or manually clone into your skills directory.

Quick Start

1. Set up the OpenClaw cron job

Ask your OpenClaw agent:

"Set up the hummingbot-heartbeat cron job"

The agent will resolve the skill path and register it with openclaw cron. Or do it manually:

# Replace <SKILL_PATH> with the actual installed path
openclaw cron add \
  --name "hummingbot-heartbeat" \
  --description "Hourly Hummingbot status check" \
  --every 1h \
  --announce \
  --channel telegram \
  --message "Run this and send output verbatim: python3 <SKILL_PATH>/scripts/bot_status.py"
2. Run manually (debug)
python3 scripts/bot_status.py
python3 scripts/bot_status.py --json

Configuration

Set via environment variables or a .env file in the skill directory:

# .env (optional — defaults shown)
HUMMINGBOT_API_URL=http://localhost:8000
API_USER=admin
API_PASS=admin
VariableDefaultDescription
HUMMINGBOT_API_URLhttp://localhost:8000Hummingbot API base URL
API_USERadminAPI username
API_PASSadminAPI password

Requirements

  • Python 3.9+
  • Hummingbot API running (see hummingbot-deploy skill)
  • Docker (optional — Gateway status check skipped if Docker unavailable)

Sample Output

🤖 Hummingbot Status — Feb 28, 2026 09:06 AM

**Infrastructure**
  API:     ✅ Up (v1.0.1)
  Gateway: ✅ Up 17 hours

**Active Bots:** none

**Active Executors:** none

**Portfolio** (total: $187.23)
  Token           Units       Price      Value
  ------------ ----------- ---------- ----------
  SOL            2.0639    $81.4996    $168.20
  USDC          19.0286     $1.0000     $19.03

What It Checks

CheckEndpointNotes
API healthGET /Returns version
Gatewaydocker ps | grep gatewaySkipped if Docker unavailable
Active botsGET /bot-orchestration/statusLists controller configs
Active executorsPOST /executors/searchFilters out CLOSED/FAILED
PortfolioPOST /portfolio/historyLatest balances with prices

Comments

Markdown supported