Heartbeat

​

तुरंत शुरू करें (शुरुआती)

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last", // explicit delivery to last contact (default is "none")
        directPolicy: "allow", // default: allow direct/DM targets; set "block" to suppress
        lightContext: true, // optional: only inject HEARTBEAT.md from bootstrap files
        isolatedSession: true, // optional: fresh session each run (no conversation history)
        skipWhenBusy: true, // optional: also defer when this agent's subagent or nested lanes are busy
        // activeHours: { start: "08:00", end: "24:00" },
        // includeReasoning: true, // optional: send separate `Thinking` message too
      },
    },
  },
}

​

डिफ़ॉल्ट

• अंतराल: 30m (या जब Anthropic OAuth/token auth detected auth mode हो, जिसमें Claude CLI reuse भी शामिल है, तब 1h)। agents.defaults.heartbeat.every या प्रति-agent agents.list[].heartbeat.every सेट करें; अक्षम करने के लिए 0m उपयोग करें।
• Prompt body (agents.defaults.heartbeat.prompt के ज़रिए configurable): 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.
• Timeout: unset heartbeat turns सेट होने पर agents.defaults.timeoutSeconds उपयोग करते हैं। अन्यथा, वे heartbeat cadence का उपयोग करते हैं, जिसे 600 seconds पर cap किया जाता है। लंबे heartbeat work के लिए agents.defaults.heartbeat.timeoutSeconds या प्रति-agent agents.list[].heartbeat.timeoutSeconds सेट करें।
• heartbeat prompt को user message के रूप में जैसा है वैसा भेजा जाता है। system prompt में “Heartbeat” section केवल तब शामिल होता है जब default agent के लिए heartbeats सक्षम हों, और run को internally flagged किया जाता है।
• जब heartbeats 0m से अक्षम किए जाते हैं, तो normal runs bootstrap context से HEARTBEAT.md भी छोड़ देते हैं ताकि मॉडल heartbeat-only निर्देश न देखे।
• Active hours (heartbeat.activeHours) configured timezone में जाँचे जाते हैं। window के बाहर, heartbeats को window के भीतर अगले tick तक skip किया जाता है।
• cron work सक्रिय या queued होने पर heartbeats अपने-आप defer हो जाते हैं। किसी agent को उसके अपने session-keyed subagent या nested command lanes पर भी defer करने के लिए heartbeat.skipWhenBusy: true सेट करें; sibling agents अब सिर्फ इसलिए pause नहीं होते कि किसी दूसरे agent का subagent work चल रहा है।

​

heartbeat prompt किसके लिए है

• Background tasks: “Consider outstanding tasks” agent को follow-ups (inbox, calendar, reminders, queued work) की समीक्षा करने और जरूरी चीज़ें सामने लाने के लिए प्रेरित करता है।
• Human check-in: “Checkup sometimes on your human during day time” कभी-कभी हल्का “कुछ चाहिए?” संदेश भेजने के लिए प्रेरित करता है, लेकिन आपकी configured local timezone का उपयोग करके रात का spam टालता है (Timezone देखें)।

​

Response contract

• अगर ध्यान देने योग्य कुछ नहीं है, तो HEARTBEAT_OK से reply करें।
• Tool-capable heartbeat runs इसके बजाय कोई visible update न देने के लिए notify: false के साथ heartbeat_respond call कर सकते हैं, या alert के लिए notify: true और notificationText उपयोग कर सकते हैं। मौजूद होने पर, structured tool response text fallback पर precedence लेता है।
• heartbeat runs के दौरान, OpenClaw HEARTBEAT_OK को ack मानता है जब यह reply के शुरू या अंत में आता है। token हटाया जाता है और यदि बची हुई content ≤ ackMaxChars (डिफ़ॉल्ट: 300) है तो reply drop कर दिया जाता है।
• यदि HEARTBEAT_OK reply के बीच में आता है, तो उसके साथ कोई विशेष व्यवहार नहीं होता।
• alerts के लिए, HEARTBEAT_OK शामिल न करें; केवल alert text लौटाएँ।

​

Config

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m", // default: 30m (0m disables)
        model: "anthropic/claude-opus-4-6",
        includeReasoning: false, // default: false (deliver separate Thinking message when available)
        lightContext: false, // default: false; true keeps only HEARTBEAT.md from workspace bootstrap files
        isolatedSession: false, // default: false; true runs each heartbeat in a fresh session (no conversation history)
        skipWhenBusy: false, // default: false; true also waits for this agent's subagent/nested lanes
        target: "last", // default: none | options: last | none | <channel id> (core or plugin, e.g. "imessage")
        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
      },
    },
  },
}

​

Scope और precedence

• agents.defaults.heartbeat global heartbeat behavior सेट करता है।
• agents.list[].heartbeat ऊपर merge होता है; यदि किसी agent में heartbeat block है, तो केवल वे agents heartbeats चलाते हैं।
• channels.defaults.heartbeat सभी channels के लिए visibility defaults सेट करता है।
• channels.<channel>.heartbeat channel defaults को override करता है।
• channels.<channel>.accounts.<id>.heartbeat (multi-account channels) per-channel settings को override करता है।

​

प्रति-agent heartbeats

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last", // explicit delivery to last contact (default is "none")
      },
    },
    list: [
      { id: "main", default: true },
      {
        id: "ops",
        heartbeat: {
          every: "1h",
          target: "whatsapp",
          to: "+15551234567",
          timeoutSeconds: 45,
          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.",
        },
      },
    ],
  },
}

​

Active hours उदाहरण

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last", // explicit delivery to last contact (default is "none")
        activeHours: {
          start: "09:00",
          end: "22:00",
          timezone: "America/New_York", // optional; uses your userTimezone if set, otherwise host tz
        },
      },
    },
  },
}

​

24/7 setup

• activeHours को पूरी तरह omit करें (कोई time-window restriction नहीं; यह default behavior है)।
• full-day window सेट करें: activeHours: { start: "00:00", end: "24:00" }।

​

Multi-account उदाहरण

{
  agents: {
    list: [
      {
        id: "ops",
        heartbeat: {
          every: "1h",
          target: "telegram",
          to: "12345678:topic:42", // optional: route to a specific topic/thread
          accountId: "ops-bot",
        },
      },
    ],
  },
  channels: {
    telegram: {
      accounts: {
        "ops-bot": { botToken: "YOUR_TELEGRAM_BOT_TOKEN" },
      },
    },
  },
}

​

Field notes

​

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

​

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

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 स्वीकृति भेजता है।
• showAlerts: जब मॉडल non-OK उत्तर लौटाता है, तो अलर्ट सामग्री भेजता है।
• useIndicator: UI स्थिति सतहों के लिए indicator events उत्सर्जित करता है।

​

प्रति-चैनल बनाम प्रति-खाता उदाहरण

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.

​

tasks: ब्लॉक

tasks:

- name: inbox-triage
  interval: 30m
  prompt: "Check for urgent unread emails and flag anything time sensitive."
- name: calendar-scan
  interval: 2h
  prompt: "Check for upcoming meetings that need prep or follow-up."

# Additional instructions

- Keep alerts short.
- If nothing needs attention after all due tasks, reply HEARTBEAT_OK.

​

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

• “HEARTBEAT.md अपडेट करके दैनिक calendar check जोड़ें।”
• “HEARTBEAT.md को फिर से लिखें ताकि यह छोटा हो और inbox follow-ups पर केंद्रित हो।”

​

मैन्युअल wake (on-demand)

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

​

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

• agents.defaults.heartbeat.includeReasoning: true

​

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

• पूरी conversation history भेजने से बचने के लिए isolatedSession: true का उपयोग करें (~100K tokens से घटकर प्रति रन ~2-5K)।
• bootstrap files को केवल HEARTBEAT.md तक सीमित करने के लिए lightContext: true का उपयोग करें।
• सस्ता model सेट करें (जैसे ollama/llama3.2:1b)।
• HEARTBEAT.md छोटा रखें।
• यदि आप केवल internal state updates चाहते हैं, तो target: "none" का उपयोग करें।

​

Heartbeat के बाद संदर्भ overflow

​

संबंधित

• ऑटोमेशन — सभी ऑटोमेशन तंत्रों का एक नज़र में अवलोकन
• पृष्ठभूमि कार्य — अलग चलाए जाने वाले कार्य को कैसे ट्रैक किया जाता है
• समयक्षेत्र — समयक्षेत्र Heartbeat शेड्यूलिंग को कैसे प्रभावित करता है
• समस्या निवारण — ऑटोमेशन समस्याओं को डीबग करना