HookPulse

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install hookpulse
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 hookpulse。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

HookPulse 是一款用于监控需按计划运行例程的死手开关。任务会向监控器发送成功签到；如果签到延迟或任务报告失败，HookPulse 会通过电子邮件或 webhook 发送提醒，并在下一次成功签到后发送恢复消息。
你可以用它监控 cron 任务、crontab、备份、webhook 和定时运行的 GitHub Actions。通过远程 MCP 服务器或 HTTPS API，Openclaw Skills 可以创建监控器、导入计划、发送运行信号并查看监控器状态，而无需自行托管监控服务。

应用场景

检测错过的夜间备份或定时维护任务。
使用 cron 表达式、时区和宽限期监控 cron 任务。
导入 crontab，并在应用前检查拟创建的监控器。
跟踪定时运行的 GitHub Actions 工作流和由 webhook 触发的例程。
记录任务开始、成功、失败或 shell 退出码信号。
查看监控器状态、近期事件、预期运行时间和公开状态页面。

工作原理

通过 HookPulse Streamable HTTP MCP 服务器连接，或调用其 HTTPS API。
创建访客身份以获取令牌。在用户登录 HookPulse 网站之前，该身份将拥有这些监控器。
使用间隔或 cron 表达式、时区、宽限期和提醒目的地创建监控器。导入 crontab 时，请先检查拟创建的监控器；只有设置 apply=1 才会创建。
为例程添加检测代码，使其在完成时发送成功签到。也可以选择发送开始信号以测量运行时长，或发送失败/退出码信号以报告运行失败。
HookPulse 每五分钟检查一次监控器。运行延迟或失败会触发提醒；随后成功签到会重置预期时间并发送恢复消息。
使用监控器和事件端点查看状态，或获取所有者的公开状态页面和信息流。

配置指南

使用 Streamable HTTP 连接到首选 MCP 服务器 https://hookpulse.net/mcp?checkout=site，或使用 https://hookpulse.net 上的 HTTP API。
创建访客令牌并妥善保管。后续 API 调用会通过 X-Guest-Token 发送该令牌。
使用间隔或 cron 计划创建监控器。对于 cron 计划，请提供时区和宽限期，并为正常延迟及任务运行时长留出余量。
在例程中添加适当的成功签到。请将监控器 ID 视为凭据：不要将其暴露在公开日志或问题帖中。
每日备份监控器的 API 设置示例：
HP=$(curl -s -X POST https://hookpulse.net/api/guest | jq -r .token)
curl -s -X POST https://hookpulse.net/api/endpoints \\n -H "X-Guest-Token: $HP" \\n -H 'content-type: application/json' \\n -d '{"name":"nightly-backup","cron":"0 3 * * *","tz":"America/Sao_Paulo","grace_sec":900}'
在 shell 例程结束时，将其退出码发送到监控器：
curl -fsS "https://hookpulse.net/in/$ID/$?"
在创建超过十个监控器或为多个监控器添加电子邮件提醒前，请先查看计费信息。如果请求返回 HTTP 402，请向用户显示价格和 https://hookpulse.net/pricing；用户需在网站上完成购买。如果返回 HTTP 429 或 503，请等待 Retry-After 指定的时间后重试一次。

数据架构

HookPulse 在远程存储监控器和签到数据；此 skill 未指定服务生成的本地文件。
数据或标识符 用途
访客令牌（hp_…） 验证 API 调用并拥有访客的监控器。以 X-Guest-Token 发送。
监控器 ID 标识监控器，也用于签到 URL。请将其视为凭据，因为任何拥有它的人都可以发送签到并解除警报。
监控器配置 包含名称、interval_sec 或带有 tz 和 grace_sec 的 cron 计划，以及提醒目的地。
监控器状态 包含状态、下次预期时间和上次签到；使用 get_endpoint 获取，或使用 list_endpoints 列出监控器。
事件 近期监控器签到和信号，可通过 list_events 获取。
设置密钥和 slug 接收密钥支持 /in/{key}/{slug} 签到；使用名称进行的首次签到会创建对应监控器。
状态信息流 所有者监控器的公开状态页面和信息流，通过 status_feed_url 获取。
导入 crontab 时，每行会建议创建一个监控器；只有明确使用 apply=1 应用后才会写入监控器。

高级特性

MCP 和 HTTP 访问：
使用远程 Streamable HTTP MCP 服务器，或直接调用对应的 API 路由。
可审核的 crontab 导入：
将 crontab 行转换为拟创建的监控器，并要求明确应用后才创建。
批量任务检测：
获取接收设置密钥，并按监控器名称签到；首次签到会创建该监控器。
运行生命周期信号：
记录开始、成功签到、明确失败和 shell 退出码。退出码 0 表示成功；
表示失败。
运行状况可见性：
查看监控器状态、下次预期时间、事件历史和覆盖所有者监控器的公开状态信息流。
即用型模板：
获取适用于 curl、crontab、n8n、GitHub Actions 和提醒 JSON 的代码片段。
安全的账户处理：
查询当前计费和价格，不依赖记忆中的价格；用户在 HookPulse 网站上完成购买。
提醒时间说明：
服务每五分钟检查一次，因此提醒可能在配置的宽限期结束后最多五分钟送达。

name: hookpulse description: Monitor cron jobs, webhooks, backups and scheduled GitHub Actions workflows with HookPulse (hookpulse.net), a dead man's switch. Create a monitor with an interval or a cron schedule, import a crontab, send start, success and failure signals with the exit code, instrument a fleet with one setup key, and read monitor state, check-ins and the public status page. A missed or failed run alerts by e-mail or webhook. Use when a task mentions a cron job, crontab, scheduled task, heartbeat, dead man's switch, missed run, backup that stopped, or a GitHub Actions schedule. license: MIT-0
compatibility: Needs HTTPS access to hookpulse.net. Works with the remote MCP server or with plain HTTP calls.

HookPulse

HookPulse watches routines that should run on a schedule. The routine sends a check-in to its link when it runs. If the check-in is late, or the routine reports a failure, HookPulse sends an alert. The next good check-in sends a recovery message.

Connect

MCP server (preferred): https://hookpulse.net/mcp?checkout=site. Transport: Streamable HTTP. With checkout=site, the person buys on the site and the agent never pays.
HTTP API: base URL https://hookpulse.net. Each MCP tool calls one route of this API.
Identity: create_guest returns a guest token hp_…. Send it as X-Guest-Token on later calls. Keep it: the monitors belong to it until the person signs in on the site.
Discovery: GET https://hookpulse.net/api/ lists the routes, prices and limits. https://hookpulse.net/llms-full.txt has the full reference.

MCP tools

Tool HTTP Use it to

create_guest POST /api/guest Get the guest token that owns the monitors.
create_endpoint POST /api/endpoints Create a monitor: interval_sec, or cron + tz + grace_sec, and the alert destinations.
import_crontab POST /api/import/crontab Read a crontab and propose one monitor per line. Nothing is written without apply=1.
list_endpoints GET /api/endpoints List the monitors and their state.
get_endpoint GET /api/endpoints/{id} Read one monitor: state, next expected time, last check-in.
list_events GET /api/endpoints/{id}/events Read the latest check-ins of a monitor.
delete_endpoint DELETE /api/endpoints/{id} Remove a monitor.
ping_ingest GET /in/{id} Send a success check-in, as the routine does.
signal_start GET /in/{id}/start Record that a run started, to measure its duration.
signal_fail GET /in/{id}/fail Record a failed run; the alert leaves on the next five-minute check.
signal_exit_code GET /in/{id}/{exit_code} Record the shell exit code: 0 is success, 1 to 255 a failure.
ingest_key GET /api/ingest-key Get the setup key for /in/{key}/{slug}: the first check-in of a name creates its monitor.
ping_slug GET /in/{key}/{slug} Check in by name with the setup key, creating the monitor the first time.
status_feed_url GET /api/status-feed Get the public status page and feed of all monitors of the owner.
list_templates GET /api/templates Get ready snippets: curl, crontab line, n8n, GitHub Actions and the alert JSON.
billing GET /api/billing Read the free allowances, prices and the account trial.
pricing GET /api/pricing Read the current prices.

Rules

Read billing before you create more than ten monitors or add e-mail alerts to more than one monitor. Do not use a price from memory.
Never pay by yourself. If a call returns HTTP 402, show the price and https://hookpulse.net/pricing to the user. The person buys on the site.
The monitor ID is a credential: whoever has it can send check-ins and silence the alarm. Do not print it in public logs or issues. The status page link is the one to share.
A start or failure signal is not proof of life. Only a success check-in resets the expected time.
For a schedule, prefer cron with tz and a grace_sec that covers the usual delay and run time.

If you get HTTP 429 or 503, wait for the time in Retry-After and try once more.

Examples

# Guest token, then a monitor for a backup at 03:00 São Paulo time with 15 minutes of allowed delay

HP=$(curl -s -XPOST https://hookpulse.net/api/guest | jq -r .token)

curl -s -XPOST https://hookpulse.net/api/endpoints -H "X-Guest-Token: $HP" -H 'content-type: application/json' \

-d '{"name":"nightly-backup","cron":"0 3 * * *","tz":"America/Sao_Paulo","grace_sec":900}'

# At the end of the routine: the exit code of the last command
curl -fsS "https://hookpulse.net/in/$ID/$?"

Limits

The service checks monitors every five minutes, so an alert can arrive up to five minutes after the allowed delay.
Terms: https://hookpulse.net/terms. Privacy: https://hookpulse.net/privacy. Contact: contato@hookpulse.net.

Bottle Practice Games

Google Trends