hummingbot-heartbeat

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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.

这是一款OpenClaw定时任务技能，每小时运行一次，会向你连接的聊天频道（Telegram、Discord等）发送格式化的Hummingbot状态报告。报告内容涵盖API健康状况、Gateway容器、活跃机器人/控制器、执行器以及投资组合余额。

Installation

安装

bash

clawhub install hummingbot-heartbeat

Or manually clone into your skills directory.

bash

clawhub install hummingbot-heartbeat

或者手动克隆到你的技能目录中。

Quick Start

快速开始

1. Set up the OpenClaw cron job

1. 设置OpenClaw定时任务

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

undefined

向你的OpenClaw agent询问：

"Set up the hummingbot-heartbeat cron job"

Agent会解析技能路径并通过

openclaw cron

进行注册。你也可以手动设置：

bash

undefined

Replace <SKILL_PATH> with the actual installed path

替换<SKILL_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"

undefined

undefined

2. Run manually (debug)

2. 手动运行（调试）

bash

python3 scripts/bot_status.py
python3 scripts/bot_status.py --json

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

undefined

通过环境变量或技能目录下的

.env

文件进行设置：

bash

undefined

.env (optional — defaults shown)

.env（可选——以下为默认值）

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 |

HUMMINGBOT_API_URL=http://localhost:8000 API_USER=admin API_PASS=admin


| 变量 | 默认值 | 描述 |
|----------|---------|-------------|
| `HUMMINGBOT_API_URL` | `http://localhost:8000` | Hummingbot API的基础URL |
| `API_USER` | `admin` | API用户名 |
| `API_PASS` | `admin` | API密码 |

Requirements

要求

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

Python 3.9+
Hummingbot API已运行（可参考
```
hummingbot-deploy
```
技能）
Docker（可选——若Docker不可用，将跳过Gateway状态检查）

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

🤖 Hummingbot状态 — 2026年2月28日 上午09:06

**基础设施**
  API:     ✅ 正常运行（v1.0.1）
  Gateway: ✅ 已运行17小时

**活跃机器人：** 无

**活跃执行器：** 无

**投资组合**（总计：$187.23）
  代币           数量       价格      价值
  ------------ ----------- ---------- ----------
  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

检查项	端点	说明
API健康状况	`GET /`	返回版本信息
Gateway	`docker ps \| grep gateway`	若Docker不可用则跳过
活跃机器人	`GET /bot-orchestration/status`	列出控制器配置
活跃执行器	`POST /executors/search`	过滤掉已关闭/失败的执行器
投资组合	`POST /portfolio/history`	包含价格的最新余额