​

हार्टबीट (Gateway)

Heartbeat बनाम Cron? प्रत्येक का उपयोग कब करना है, इसके लिए Cron vs Heartbeat देखें।

​

त्वरित प्रारंभ (शुरुआती)

1. Heartbeat सक्षम रहने दें (डिफ़ॉल्ट 30m है, या Anthropic OAuth/setup-token के लिए 1h) या अपनी स्वयं की आवृत्ति सेट करें।
2. एजेंट वर्कस्पेस में एक छोटी HEARTBEAT.md चेकलिस्ट बनाएँ (वैकल्पिक, लेकिन अनुशंसित)।
3. तय करें कि Heartbeat संदेश कहाँ जाने चाहिए (target: "last" डिफ़ॉल्ट है)।
4. वैकल्पिक: पारदर्शिता के लिए Heartbeat reasoning डिलीवरी सक्षम करें।
5. वैकल्पिक: Heartbeat को सक्रिय घंटों तक सीमित करें (स्थानीय समय)।

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last",
        // activeHours: { start: "08:00", end: "24:00" },
        // includeReasoning: true, // optional: send separate `Reasoning:` message too
      },
    },
  },
}

​

डिफ़ॉल्ट

• Interval: 30m (or 1h when Anthropic OAuth/setup-token is the detected auth mode). Set agents.defaults.heartbeat.every or per-agent agents.list[].heartbeat.every; use 0m to disable.
• Prompt body (configurable via agents.defaults.heartbeat.prompt): Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.
• The heartbeat prompt is sent verbatim as the user message. The system prompt includes a “Heartbeat” section and the run is flagged internally.
• Active hours (heartbeat.activeHours) are checked in the configured timezone. Outside the window, heartbeats are skipped until the next tick inside the window.

​

Heartbeat प्रॉम्प्ट का उद्देश्य

• पृष्ठभूमि कार्य: “Consider outstanding tasks” एजेंट को फ़ॉलो-अप (इनबॉक्स, कैलेंडर, रिमाइंडर, कतारबद्ध कार्य) की समीक्षा करने और किसी भी तात्कालिक चीज़ को सामने लाने के लिए प्रेरित करता है।
• Human check-in: “Checkup sometimes on your human during day time” nudges an occasional lightweight “anything you need?” message, but avoids night-time spam by using your configured local timezone (see /concepts/timezone).

​

प्रतिक्रिया अनुबंध

• यदि किसी चीज़ पर ध्यान देने की आवश्यकता नहीं है, तो HEARTBEAT_OK के साथ उत्तर दें।
• During heartbeat runs, OpenClaw treats HEARTBEAT_OK as an ack when it appears at the start or end of the reply. The token is stripped and the reply is dropped if the remaining content is ≤ ackMaxChars (default: 300).
• यदि HEARTBEAT_OK उत्तर के मध्य में दिखाई देता है, तो इसे विशेष रूप से नहीं माना जाता।
• अलर्ट के लिए, HEARTBEAT_OK शामिल न करें; केवल अलर्ट पाठ लौटाएँ।

​

विन्यास

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m", // default: 30m (0m disables)
        model: "anthropic/claude-opus-4-6",
        includeReasoning: false, // default: false (deliver separate Reasoning: message when available)
        target: "last", // last | none | <channel id> (core or plugin, e.g. "bluebubbles")
        to: "+15551234567", // optional channel-specific override
        accountId: "ops-bot", // optional multi-account channel id
        prompt: "Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.",
        ackMaxChars: 300, // max chars allowed after HEARTBEAT_OK
      },
    },
  },
}

​

स्कोप और प्राथमिकता

• agents.defaults.heartbeat वैश्विक Heartbeat व्यवहार सेट करता है।
• agents.list[].heartbeat ऊपर से मर्ज होता है; यदि किसी भी एजेंट में heartbeat ब्लॉक है, तो केवल वही एजेंट Heartbeat चलाते हैं।
• channels.defaults.heartbeat सभी चैनलों के लिए दृश्यता डिफ़ॉल्ट सेट करता है।
• channels.<channel>.heartbeat overrides channel defaults.
• channels.<channel>.accounts.<id>.heartbeat (multi-account channels) overrides per-channel settings.

​

प्रति-एजेंट Heartbeat

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last",
      },
    },
    list: [
      { id: "main", default: true },
      {
        id: "ops",
        heartbeat: {
          every: "1h",
          target: "whatsapp",
          to: "+15551234567",
          prompt: "Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.",
        },
      },
    ],
  },
}

​

सक्रिय घंटे का उदाहरण

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last",
        activeHours: {
          start: "09:00",
          end: "22:00",
          timezone: "America/New_York", // optional; uses your userTimezone if set, otherwise host tz
        },
      },
    },
  },
}

​

मल्टी-अकाउंट उदाहरण

{
  agents: {
    list: [
      {
        id: "ops",
        heartbeat: {
          every: "1h",
          target: "telegram",
          to: "12345678",
          accountId: "ops-bot",
        },
      },
    ],
  },
  channels: {
    telegram: {
      accounts: {
        "ops-bot": { botToken: "YOUR_TELEGRAM_BOT_TOKEN" },
      },
    },
  },
}

​

फ़ील्ड नोट्स

• every: Heartbeat अंतराल (अवधि स्ट्रिंग; डिफ़ॉल्ट इकाई = मिनट)।
• model: Heartbeat रन के लिए वैकल्पिक मॉडल ओवरराइड (provider/model)।
• includeReasoning: सक्षम होने पर, उपलब्ध होने पर अलग Reasoning: संदेश भी डिलीवर करता है (आकार /reasoning on जैसा ही)।
• session: Heartbeat रन के लिए वैकल्पिक सत्र कुंजी।
  • main (डिफ़ॉल्ट): एजेंट मुख्य सत्र।
  • स्पष्ट सत्र कुंजी (openclaw sessions --json या sessions CLI से कॉपी करें)।
  • सत्र कुंजी प्रारूप: Sessions और Groups देखें।
• target:
  • last (डिफ़ॉल्ट): अंतिम उपयोग किए गए बाहरी चैनल पर डिलीवर करें।
  • स्पष्ट चैनल: whatsapp / telegram / discord / googlechat / slack / msteams / signal / imessage।
  • none: Heartbeat चलाएँ लेकिन बाहरी रूप से डिलीवर न करें।
• to: वैकल्पिक प्राप्तकर्ता ओवरराइड (चैनल-विशिष्ट आईडी, जैसे WhatsApp के लिए E.164 या Telegram चैट आईडी)।
• accountId: मल्टी-अकाउंट चैनलों के लिए वैकल्पिक अकाउंट आईडी। जब target: "last" हो, तो अकाउंट आईडी resolved अंतिम चैनल पर लागू होती है यदि वह अकाउंट्स को सपोर्ट करता है; अन्यथा इसे अनदेखा कर दिया जाता है। यदि अकाउंट आईडी resolved चैनल के लिए कॉन्फ़िगर किए गए किसी अकाउंट से मेल नहीं खाती, तो डिलीवरी स्किप कर दी जाती है।
• prompt: डिफ़ॉल्ट प्रॉम्प्ट बॉडी को ओवरराइड करता है (मर्ज नहीं किया जाता)।
• ackMaxChars: HEARTBEAT_OK के बाद डिलीवरी से पहले अनुमत अधिकतम वर्ण।
• activeHours: हार्टबीट रन को एक समय विंडो तक सीमित करता है। start (HH:MM, inclusive), end (HH:MM exclusive; दिन के अंत के लिए 24:00 अनुमत), और वैकल्पिक timezone के साथ ऑब्जेक्ट।
  • छोड़ा गया या "user": यदि सेट है तो आपके agents.defaults.userTimezone का उपयोग करता है, अन्यथा होस्ट सिस्टम टाइमज़ोन पर वापस जाता है।
  • "local": हमेशा होस्ट सिस्टम टाइमज़ोन का उपयोग करता है।
  • कोई भी IANA पहचानकर्ता (जैसे America/New_York): सीधे उपयोग किया जाता है; यदि अमान्य है, तो ऊपर दिए गए "user" व्यवहार पर वापस जाता है।
  • सक्रिय विंडो के बाहर, Heartbeat को विंडो के भीतर अगले टिक तक छोड़ा जाता है।

​

डिलीवरी व्यवहार

• हार्टबीट्स डिफ़ॉल्ट रूप से एजेंट के मुख्य सत्र में चलते हैं (agent:<id>:<mainKey>), या global जब session.scope = "global" हो। session को सेट करके किसी विशिष्ट चैनल सत्र (Discord/WhatsApp/etc.) पर ओवरराइड करें।
• session केवल रन संदर्भ को प्रभावित करता है; डिलीवरी target और to द्वारा नियंत्रित होती है।
• किसी विशिष्ट चैनल/प्राप्तकर्ता को डिलीवर करने के लिए target + to सेट करें। target: "last" के साथ, डिलीवरी उस सत्र के लिए अंतिम बाहरी चैनल का उपयोग करती है।
• यदि मुख्य कतार व्यस्त है, तो Heartbeat छोड़ा जाता है और बाद में पुनः प्रयास किया जाता है।
• यदि target किसी बाहरी गंतव्य में हल नहीं होता, तो रन फिर भी होता है लेकिन कोई आउटबाउंड संदेश नहीं भेजा जाता।
• केवल Heartbeat प्रतिक्रियाएँ सत्र को जीवित नहीं रखतीं; अंतिम updatedAt पुनर्स्थापित किया जाता है ताकि निष्क्रिय समाप्ति सामान्य रूप से व्यवहार करे।

​

दृश्यता नियंत्रण

channels:
  defaults:
    heartbeat:
      showOk: false # Hide HEARTBEAT_OK (default)
      showAlerts: true # Show alert messages (default)
      useIndicator: true # Emit indicator events (default)
  telegram:
    heartbeat:
      showOk: true # Show OK acknowledgments on Telegram
  whatsapp:
    accounts:
      work:
        heartbeat:
          showAlerts: false # Suppress alert delivery for this account

​

प्रत्येक फ़्लैग क्या करता है

• showOk: जब मॉडल केवल OK वाला उत्तर लौटाता है, तो HEARTBEAT_OK acknowledgment भेजता है।
• showAlerts: जब मॉडल गैर-OK उत्तर लौटाता है, तो अलर्ट सामग्री भेजता है।
• useIndicator: UI स्थिति सतहों के लिए संकेतक इवेंट उत्पन्न करता है।

​

प्रति-चैनल बनाम प्रति-अकाउंट उदाहरण

channels:
  defaults:
    heartbeat:
      showOk: false
      showAlerts: true
      useIndicator: true
  slack:
    heartbeat:
      showOk: true # all Slack accounts
    accounts:
      ops:
        heartbeat:
          showAlerts: false # suppress alerts for the ops account only
  telegram:
    heartbeat:
      showOk: true

​

सामान्य पैटर्न

​

HEARTBEAT.md (वैकल्पिक)

# Heartbeat checklist

- Quick scan: anything urgent in inboxes?
- If it’s daytime, do a lightweight check-in if nothing else is pending.
- If a task is blocked, write down _what is missing_ and ask Peter next time.

​

क्या एजेंट HEARTBEAT.md को अपडेट कर सकता है?

• “दैनिक कैलेंडर जाँच जोड़ने के लिए HEARTBEAT.md अपडेट करें।”
• “HEARTBEAT.md को फिर से लिखें ताकि यह छोटा हो और इनबॉक्स फ़ॉलो-अप पर केंद्रित हो।”

​

मैनुअल वेक (ऑन-डिमांड)

openclaw system event --text "Check for urgent follow-ups" --mode now

​

Reasoning डिलीवरी (वैकल्पिक)

• agents.defaults.heartbeat.includeReasoning: true

​

लागत जागरूकता