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 (або 1h, коли виявлений режим автентифікації — Anthropic OAuth/токен, включно з повторним використанням Claude CLI). Задайте agents.defaults.heartbeat.every або agents.list[].heartbeat.every для окремого агента; використовуйте 0m, щоб вимкнути.
• Тіло запиту (налаштовується через 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.
• Тайм-аут: heartbeat-ходи без заданого значення використовують agents.defaults.timeoutSeconds, якщо його встановлено. Інакше вони використовують інтервал heartbeat з обмеженням до 600 секунд. Задайте agents.defaults.heartbeat.timeoutSeconds або agents.list[].heartbeat.timeoutSeconds для окремого агента, якщо потрібна довша робота heartbeat.
• Запит heartbeat надсилається дослівно як повідомлення користувача. Системний запит містить розділ “Heartbeat” лише коли heartbeats увімкнені для типового агента, а запуск позначається внутрішньо.
• Коли heartbeats вимкнено через 0m, звичайні запуски також не включають HEARTBEAT.md у контекст початкового завантаження, щоб модель не бачила інструкції лише для heartbeat.
• Активні години (heartbeat.activeHours) перевіряються в налаштованому часовому поясі. Поза вікном heartbeats пропускаються до наступного такту всередині вікна.
• Heartbeats автоматично відкладаються, доки cron-робота активна або перебуває в черзі. Установіть heartbeat.skipWhenBusy: true, щоб також відкладати агента на його власних прив’язаних до ключа сеансу субагентських або вкладених командних смугах; суміжні агенти більше не призупиняються лише тому, що інший агент має субагентську роботу в процесі.

​

Для чого призначений запит heartbeat

• Фонові завдання: “Consider outstanding tasks” підштовхує агента переглядати подальші дії (вхідні, календар, нагадування, роботу в черзі) і виводити на поверхню все термінове.
• Перевірка людини: “Checkup sometimes on your human during day time” підштовхує інколи надсилати легке повідомлення “щось потрібно?”, але уникає нічного спаму завдяки вашому налаштованому місцевому часовому поясу (див. Часовий пояс).

​

Контракт відповіді

• Якщо нічого не потребує уваги, відповідайте HEARTBEAT_OK.
• Heartbeat-запуски з доступом до інструментів можуть натомість викликати heartbeat_respond з notify: false для невидимого оновлення або notify: true плюс notificationText для сповіщення. Якщо структурована відповідь інструмента присутня, вона має пріоритет над текстовим запасним варіантом.
• Під час heartbeat-запусків OpenClaw трактує HEARTBEAT_OK як підтвердження, коли він з’являється на початку або в кінці відповіді. Токен вилучається, а відповідь відкидається, якщо решта вмісту має ≤ ackMaxChars (типово: 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 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
      },
    },
  },
}

​

Область дії та пріоритет

• agents.defaults.heartbeat задає глобальну поведінку heartbeat.
• agents.list[].heartbeat накладається зверху; якщо будь-який агент має блок heartbeat, heartbeats запускають лише ці агенти.
• channels.defaults.heartbeat задає типові параметри видимості для всіх каналів.
• channels.<channel>.heartbeat перевизначає типові параметри каналу.
• channels.<channel>.accounts.<id>.heartbeat (канали з кількома обліковими записами) перевизначає параметри для каналу.

​

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.",
        },
      },
    ],
  },
}

​

Приклад активних годин

{
  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

• Повністю опустіть activeHours (без обмеження часовим вікном; це типова поведінка).
• Задайте вікно на весь день: activeHours: { start: "00:00", end: "24:00" }.

​

Приклад кількох облікових записів

{
  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" },
      },
    },
  },
}

​

Примітки до полів

​

Поведінка доставки

​

Елементи керування видимістю

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: надсилає підтвердження HEARTBEAT_OK, коли модель повертає відповідь лише OK.
• showAlerts: надсилає вміст сповіщення, коли модель повертає відповідь не OK.
• useIndicator: емiтує події індикатора для поверхонь статусу 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.

​

Блоки 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?

• “Update HEARTBEAT.md to add a daily calendar check.”
• “Rewrite HEARTBEAT.md so it’s shorter and focused on inbox follow-ups.”

​

Ручне пробудження (на вимогу)

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

​

Доставка reasoning (необов’язково)

• agents.defaults.heartbeat.includeReasoning: true

​

Обізнаність про вартість

• Використовуйте isolatedSession: true, щоб не надсилати повну історію розмови (від ~100K токенів до ~2-5K за запуск).
• Використовуйте lightContext: true, щоб обмежити bootstrap-файли лише HEARTBEAT.md.
• Установіть дешевшу model (наприклад, ollama/llama3.2:1b).
• Тримайте HEARTBEAT.md малим.
• Використовуйте target: "none", якщо вам потрібні лише оновлення внутрішнього стану.

​

Переповнення контексту після Heartbeat

​

Пов’язане

• Автоматизація — усі механізми автоматизації з першого погляду
• Фонові завдання — як відстежується відокремлена робота
• Часовий пояс — як часовий пояс впливає на планування Heartbeat
• Усунення несправностей — налагодження проблем автоматизації