# Send Heartbeat to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "heartbeat",
    "name": "Heartbeat",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/ivangdavila/heartbeat",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/heartbeat",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/heartbeat",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=heartbeat",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "heartbeat-template.md",
      "intervals.md",
      "memory-template.md",
      "qa-checklist.md",
      "setup.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "heartbeat",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T20:28:32.983Z",
      "expiresAt": "2026-05-08T20:28:32.983Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=heartbeat",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=heartbeat",
        "contentDisposition": "attachment; filename=\"heartbeat-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "heartbeat"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/heartbeat"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/heartbeat",
    "downloadUrl": "https://openagent3.xyz/downloads/heartbeat",
    "agentUrl": "https://openagent3.xyz/skills/heartbeat/agent",
    "manifestUrl": "https://openagent3.xyz/skills/heartbeat/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/heartbeat/agent.md"
  }
}
```
## Documentation

### Heartbeat 💓

Build reliable heartbeat playbooks for OpenClaw agents without noisy checks, missed signals, or runaway costs.

### Setup

On first use, follow setup.md to capture timezone, active hours, precision needs, and risk tolerance.

### When to Use

User wants a better heartbeat file in OpenClaw. Agent audits current heartbeat behavior, designs a safer file, and tunes intervals using real workflow constraints.

Use this for adaptive monitoring, proactive check-ins, and hybrid heartbeat plus cron strategies.

### Architecture

Memory lives in ~/heartbeat/. See memory-template.md for the structure and fields.

~/heartbeat/
├── memory.md              # Preferences, cadence profile, and last tuning decisions
├── drafts/                # Candidate heartbeat variants
└── snapshots/             # Previous heartbeat versions for rollback

### Quick Reference

TopicFileSetup interviewsetup.mdMemory schemamemory-template.mdProduction heartbeat templateheartbeat-template.mdPractical heartbeat use casesuse-cases.mdInterval strategy referenceintervals.mdTrigger strategy referencetriggers.mdValidation checklist before shippingqa-checklist.mdInternet research sourcessources.md

### 1. Scope the heartbeat before writing anything

Define one mission sentence and 1-3 monitored signals first.

If scope is broad, split into explicit sections (critical, important, nice-to-have) and only automate the first two.

### 2. Keep output contract strict

If nothing actionable is found, heartbeat must return exactly HEARTBEAT_OK.

Do not emit summaries on empty cycles. This prevents noisy loops and keeps heartbeat cheap.

### 3. Tune cadence with timezone and active hours

Start from OpenClaw defaults and adapt: use a moderate baseline interval, then tighten only during active windows.

Always encode timezone and active hours in the heartbeat file to avoid waking during sleep hours.

### 4. Use cron for exact timing, heartbeat for adaptive timing

If a task must run at exact wall-clock times, move it to cron.

If a task should react to changing context or event probability, keep it in heartbeat.

### 5. Add cost guards to every expensive check

Use a two-stage pattern: cheap precheck first, expensive action only on threshold hit.

Never call paid APIs on every heartbeat cycle unless the user explicitly accepts the cost.

### 6. Define escalation and cooldown rules

Each alert condition must have trigger threshold, escalation route, and cooldown period.

No escalation path means no alert. No cooldown means likely alert spam.

### 7. Validate with dry runs and rollback path

Before finalizing, run at least one dry simulation against the checklist in qa-checklist.md.

Keep a snapshot of the previous heartbeat so the user can rollback in one step.

### Common Traps

Polling everything every cycle -> high token/API burn with low signal quality.
Using heartbeat for exact 09:00 jobs -> drift and missed exact-time expectations.
Missing timezone in heartbeat config -> notifications at the wrong local time.
No active-hours filter -> overnight wakeups and user fatigue.
No HEARTBEAT_OK fallback -> verbose no-op loops.
No cooldown on alerts -> duplicate escalations during noisy incidents.

### Security & Privacy

Data that stays local:

Heartbeat preferences and tuning notes in ~/heartbeat/
Draft and snapshot files for heartbeat definitions

This skill does NOT:

Require credentials by default
Trigger external APIs without user-approved instructions
Edit unrelated files outside the heartbeat workflow

### Related Skills

Install with clawhub install <slug> if user confirms:

schedule - Scheduling patterns for recurring workflows
monitoring - Monitoring strategies and alert design
alerts - Alert routing and escalation hygiene
workflow - Multi-step workflow orchestration
copilot - Proactive assistant patterns with controlled autonomy

### Feedback

If useful: clawhub star heartbeat
Stay updated: clawhub sync
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ivangdavila
- Version: 1.0.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-01T20:28:32.983Z
- Expires at: 2026-05-08T20:28:32.983Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/heartbeat)
- [Send to Agent page](https://openagent3.xyz/skills/heartbeat/agent)
- [JSON manifest](https://openagent3.xyz/skills/heartbeat/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/heartbeat/agent.md)
- [Download page](https://openagent3.xyz/downloads/heartbeat)