How do I install the Hummingbot Heartbeat skill?

Run npx skillmds@latest add hummingbot/hummingbot-heartbeat in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Hummingbot Heartbeat safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Hummingbot Heartbeat?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Hummingbot Heartbeat free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Hummingbot Heartbeat?

hummingbot (@hummingbot) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Hummingbot Heartbeat by hummingbot — Agent Skill

Name: Hummingbot Heartbeat
Rating: 4.2 (5 reviews)
Author: hummingbot

File contents

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

Variable	Default	Description
`HUMMINGBOT_API_URL`	`http://localhost:8000`	Hummingbot API base URL
`API_USER`	`admin`	API username
`API_PASS`	`admin`	API 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

Check	Endpoint	Notes
API health	`GET /`	Returns version
Gateway	`docker ps \| grep gateway`	Skipped if Docker unavailable
Active bots	`GET /bot-orchestration/status`	Lists controller configs
Active executors	`POST /executors/search`	Filters out CLOSED/FAILED
Portfolio	`POST /portfolio/history`	Latest balances with prices

---name: hummingbot-heartbeatdescription: OpenClaw cron job that delivers hourly Hummingbot status updates to your chat — API health, Gateway container, active bots/controllers, executors, and portfolio balances.--- # 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 ```bash 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: ```bash # 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) ```bash python3 scripts/bot_status.py python3 scripts/bot_status.py --json ``` ## Configuration Set via environment variables or a `.env` file in the skill directory: ```bash # .env (optional — defaults shown) HUMMINGBOT_API_URL=http://localhost:8000 API_USER=admin API_PASS=admin ``` | Variable | Default | Description | |----------|---------|-------------| | `HUMMINGBOT_API_URL` | `http://localhost:8000` | Hummingbot API base URL | | `API_USER` | `admin` | API username | | `API_PASS` | `admin` | API 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 | Check | Endpoint | Notes | |-------|----------|-------| | API health | `GET /` | Returns version | | Gateway | `docker ps \| grep gateway` | Skipped if Docker unavailable | | Active bots | `GET /bot-orchestration/status` | Lists controller configs | | Active executors | `POST /executors/search` | Filters out CLOSED/FAILED | | Portfolio | `POST /portfolio/history` | Latest balances with prices |

Frequently asked questions

Hummingbot Heartbeat