Heartbeat

​

Быстрый старт (для начинающих)

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last", // явная доставка последнему контакту (по умолчанию — "none")
        directPolicy: "allow", // по умолчанию разрешены прямые адресаты и личные сообщения; задайте "block", чтобы отключить
        lightContext: true, // необязательно: добавлять из файлов начального контекста только HEARTBEAT.md
        isolatedSession: true, // необязательно: новый сеанс при каждом запуске (без истории переписки)
        skipWhenBusy: true, // необязательно: также откладывать, когда заняты субагент этого агента или вложенные каналы выполнения
        // activeHours: { start: "08:00", end: "24:00" },
        // includeReasoning: true, // необязательно: также отправлять отдельное сообщение `Thinking`
      },
    },
  },
}

​

Значения по умолчанию

• Интервал: 30m. Применение настроек провайдера Anthropic по умолчанию увеличивает его до 1h, когда определённый режим аутентификации — OAuth/токен (включая повторное использование Claude CLI), но только пока heartbeat.every не задан. Задайте 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 секунд. Для более продолжительной работы Heartbeat задайте agents.defaults.heartbeat.timeoutSeconds или agents.list[].heartbeat.timeoutSeconds для отдельного агента.
• Запрос Heartbeat отправляется без изменений в качестве пользовательского сообщения. Системный запрос содержит раздел «Heartbeats» только тогда, когда Heartbeat включён для агента по умолчанию (и includeSystemPromptSection не равен false); запуск при этом помечается внутренним флагом.
• Когда Heartbeat отключён с помощью 0m, обычные запуски также исключают HEARTBEAT.md из начального контекста, чтобы модель не видела инструкции, предназначенные только для Heartbeat.
• Активные часы (heartbeat.activeHours) проверяются в настроенном часовом поясе. Вне этого временного окна Heartbeat пропускается до следующего запуска внутри окна.
• Heartbeat автоматически откладывается, пока выполняется или ожидает выполнения работа Cron. Задайте heartbeat.skipWhenBusy: true, чтобы также откладывать запуск агента, когда заняты его собственный привязанный к ключу сеанса субагент или вложенные каналы выполнения команд; агенты того же уровня больше не приостанавливаются только из-за того, что другой агент выполняет работу субагента.

​

Для чего предназначен запрос Heartbeat

• Фоновые задачи: фраза «Рассмотри незавершённые задачи» побуждает агента проверить последующие действия (входящие сообщения, календарь, напоминания, работу в очереди) и сообщить обо всём срочном.
• Проверка состояния пользователя: фраза «Иногда в течение дня интересуйся состоянием своего пользователя» побуждает изредка отправлять короткое сообщение «Вам что-нибудь нужно?», но позволяет избежать ночного потока сообщений благодаря настроенному местному часовому поясу (см. раздел «Часовой пояс»).

​

Контракт ответа

• Если ничто не требует внимания, ответьте 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", // по умолчанию: 30m (0m отключает)
        model: "anthropic/claude-opus-4-6",
        includeReasoning: false, // по умолчанию: false (при наличии доставлять отдельное сообщение Thinking)
        lightContext: false, // по умолчанию: false; значение true оставляет из файлов начального контекста рабочего пространства только HEARTBEAT.md
        isolatedSession: false, // по умолчанию: false; значение true запускает каждый Heartbeat в новом сеансе (без истории переписки)
        skipWhenBusy: false, // по умолчанию: false; значение true также ожидает освобождения каналов субагента или вложенных каналов этого агента
        target: "last", // по умолчанию: none | варианты: last | none | <channel id> (ядро или плагин, например "imessage")
        to: "+15551234567", // необязательное переопределение для конкретного канала
        accountId: "ops-bot", // необязательный идентификатор канала с несколькими учётными записями
        prompt: "Прочитай HEARTBEAT.md, если он существует (контекст рабочего пространства). Строго следуй ему. Не выводи и не повторяй старые задачи из предыдущих разговоров. Если ничто не требует внимания, ответь HEARTBEAT_OK.",
        includeSystemPromptSection: true, // по умолчанию: true; значение false исключает раздел системного запроса ## Heartbeats для агента по умолчанию
        ackMaxChars: 300, // максимальное количество символов после HEARTBEAT_OK
      },
    },
  },
}

​

Область действия и приоритет

• agents.defaults.heartbeat задаёт глобальное поведение Heartbeat.
• agents.list[].heartbeat накладывается поверх него; если хотя бы у одного агента есть блок heartbeat, Heartbeat выполняют только эти агенты.
• channels.defaults.heartbeat задаёт параметры видимости по умолчанию для всех каналов.
• channels.<channel>.heartbeat переопределяет параметры каналов по умолчанию.
• channels.<channel>.accounts.<id>.heartbeat (для каналов с несколькими учётными записями) переопределяет настройки отдельного канала.

​

Heartbeat для отдельных агентов

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last", // явная доставка последнему контакту (по умолчанию — "none")
      },
    },
    list: [
      { id: "main", default: true },
      {
        id: "ops",
        heartbeat: {
          every: "1h",
          target: "whatsapp",
          to: "+15551234567",
          timeoutSeconds: 45,
          prompt: "Прочитай HEARTBEAT.md, если он существует (контекст рабочего пространства). Строго следуй ему. Не выводи и не повторяй старые задачи из предыдущих разговоров. Если ничто не требует внимания, ответь HEARTBEAT_OK.",
        },
      },
    ],
  },
}

​

Пример активных часов

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last", // явная доставка последнему контакту (по умолчанию — "none")
        activeHours: {
          start: "09:00",
          end: "22:00",
          timezone: "America/New_York", // необязательно; использует userTimezone, если он задан, иначе часовой пояс хоста
        },
      },
    },
  },
}

​

Работа 24/7

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

​

Пример с несколькими учётными записями

{
  agents: {
    list: [
      {
        id: "ops",
        heartbeat: {
          every: "1h",
          target: "telegram",
          to: "12345678:topic:42", // необязательно: направлять в определённую тему или ветку
          accountId: "ops-bot",
        },
      },
    ],
  },
  channels: {
    telegram: {
      accounts: {
        "ops-bot": { botToken: "YOUR_TELEGRAM_BOT_TOKEN" },
      },
    },
  },
}

​

Описание полей

​

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

​

Управление видимостью

channels:
  defaults:
    heartbeat:
      showOk: false # Скрывать HEARTBEAT_OK (по умолчанию)
      showAlerts: true # Показывать сообщения оповещений (по умолчанию)
      useIndicator: true # Создавать события индикатора (по умолчанию)
  telegram:
    heartbeat:
      showOk: true # Показывать подтверждения OK в Telegram
  whatsapp:
    accounts:
      work:
        heartbeat:
          showAlerts: false # Не доставлять оповещения для этой учётной записи

​

Назначение каждого флага

• showOk: отправляет подтверждение HEARTBEAT_OK, когда модель возвращает ответ, содержащий только OK.
• showAlerts: отправляет содержимое оповещения, когда модель возвращает ответ, отличный от OK.
• useIndicator: создаёт события индикатора для отображения состояния в интерфейсе.

​

Примеры настроек для канала и учётной записи

channels:
  defaults:
    heartbeat:
      showOk: false
      showAlerts: true
      useIndicator: true
  slack:
    heartbeat:
      showOk: true # все учётные записи Slack
    accounts:
      ops:
        heartbeat:
          showAlerts: false # отключить оповещения только для учётной записи ops
  telegram:
    heartbeat:
      showOk: true

​

Распространённые схемы

​

HEARTBEAT.md (необязательно)

# Контрольный список Heartbeat

- Быстро проверить: нет ли чего-нибудь срочного во входящих?
- Если сейчас день и других ожидающих задач нет, выполнить быструю проверку состояния.
- Если задача заблокирована, записать, _чего не хватает_, и в следующий раз спросить Питера.

​

Блоки tasks:

tasks:

- name: inbox-triage
  interval: 30m
  prompt: "Проверь срочные непрочитанные письма и отметь всё, что требует скорого ответа."
- name: calendar-scan
  interval: 2h
  prompt: "Проверь предстоящие встречи, к которым нужно подготовиться или по итогам которых требуются действия."

# Дополнительные инструкции

- Оповещения должны быть краткими.
- Если после выполнения всех наступивших задач ничто не требует внимания, ответь HEARTBEAT_OK.

​

Может ли агент обновлять HEARTBEAT.md?

• «Обнови HEARTBEAT.md, добавив ежедневную проверку календаря».
• «Перепиши HEARTBEAT.md, чтобы сделать его короче и сосредоточить на дальнейшей работе с входящими сообщениями».

​

Ручная активация (по требованию)

openclaw system event --text "Проверь, не требуются ли срочные последующие действия" --mode now

openclaw system heartbeat last     # показать последнее событие Heartbeat
openclaw system heartbeat enable   # включить Heartbeat
openclaw system heartbeat disable  # отключить Heartbeat

​

Передача рассуждений (необязательно)

• agents.defaults.heartbeat.includeReasoning: true

​

Учёт затрат

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

​

Переполнение контекста после Heartbeat

​

Связанные материалы

• Автоматизация — краткий обзор всех механизмов автоматизации
• Фоновые задачи — как отслеживается работа, выполняемая в отсоединённом режиме
• Часовой пояс — как часовой пояс влияет на расписание Heartbeat
• Устранение неполадок — диагностика проблем автоматизации