Heartbeat

​

Hızlı başlangıç (yeni başlayanlar)

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last", // son kişiye açıkça teslim et (varsayılan "none")
        directPolicy: "allow", // varsayılan: doğrudan/DM hedeflerine izin ver; engellemek için "block" olarak ayarla
        lightContext: true, // isteğe bağlı: Heartbeat çalıştırmalarında çalışma alanı başlangıç dosyalarını atla
        isolatedSession: true, // isteğe bağlı: her çalıştırmada yeni oturum (konuşma geçmişi yok)
        // activeHours: { start: "08:00", end: "24:00" },
      },
    },
  },
}

​

Varsayılanlar

• Aralık: 30m. Anthropic sağlayıcı varsayılanlarının uygulanması, çözümlenen kimlik doğrulama modu OAuth/token olduğunda (Claude CLI’ın yeniden kullanımı dâhil) bunu 1h değerine yükseltir, ancak yalnızca heartbeat.every ayarlanmamışsa. agents.defaults.heartbeat.every veya agent başına agents.entries.*.heartbeat.every değerini ayarlayın; devre dışı bırakmak için 0m kullanın.
• İstem gövdesi (agents.defaults.heartbeat.prompt aracılığıyla yapılandırılabilir): Follow the heartbeat monitor scratch context when provided. Recurring tasks are cron jobs; create or change their schedules with cron tools or the openclaw cron CLI, not heartbeat scratch. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.
• Zaman aşımı: zaman aşımı ayarlanmamış Heartbeat turları, agents.defaults.timeoutSeconds ayarlandığında bu değeri kullanır. Aksi takdirde 600 saniyeyle sınırlandırılmış Heartbeat sıklığını kullanırlar. Daha uzun Heartbeat çalışmaları için agents.defaults.heartbeat.timeoutSeconds veya agent başına agents.entries.*.heartbeat.timeoutSeconds değerini ayarlayın.
• Heartbeat istemi, kullanıcı iletisi olarak aynen gönderilir. Varsayılan agent için Heartbeat’ler etkinleştirildiğinde sistem istemi bir “Heartbeat’ler” bölümü içerir ve çalıştırma dâhili olarak işaretlenir.
• Heartbeat’ler 0m ile devre dışı bırakıldığında izleyici cron işi kalır ancak devre dışı olur ve sıklığı yeniden etkinleştirdiğinizde kullanılmak üzere notları korunur.
• Cron’ın kendisi devre dışı bırakıldığında Heartbeat sıklığı etkin kalmış olsa bile zamanlanmış Heartbeat’ler çalışmaz.
• Etkin saatler (heartbeat.activeHours) yapılandırılmış saat diliminde denetlenir. Pencerenin dışında Heartbeat’ler, pencere içindeki bir sonraki tetiklemeye kadar atlanır.
• Cron çalışması etkin veya kuyruktayken ya da söz konusu agent’ın oturum anahtarlı alt agent veya iç içe komut hatları meşgulken Heartbeat’ler otomatik olarak ertelenir. Eşdüzey agent’lar birbirini duraklatmaz.

​

Heartbeat isteminin amacı

• Arka plan görevleri: “Bekleyen görevleri göz önünde bulundurun” ifadesi, agent’ı takip işlerini (gelen kutusu, takvim, anımsatıcılar, kuyruktaki çalışmalar) incelemeye ve acil olan her şeyi belirtmeye yönlendirir.
• Kullanıcıyla durum kontrolü: “Gündüzleri bazen kullanıcınızın durumunu kontrol edin” ifadesi, ara sıra kısa bir “bir şeye ihtiyacınız var mı?” iletisini teşvik eder ancak yapılandırılmış yerel saat diliminizi kullanarak gece ileti yağmurunu önler (bkz. Saat Dilimi).

​

Yanıt sözleşmesi

• İlgilenilmesi gereken bir şey yoksa HEARTBEAT_OK ile yanıt verin.
• Heartbeat çalıştırmaları bunun yerine görünür bir güncelleme olmaması için notify: false ile heartbeat_respond çağrısı veya uyarı için notificationText ile notify: true çağrısı yapabilir. Yapılandırılmış araç yanıtı mevcut olduğunda metin yedeğine göre önceliklidir.
• notify: false içeren anlamlı bir heartbeat_respond sonucu sessiz kalır ancak söz konusu oturumdaki bir sonraki kullanıcı turu için sınırlı dâhili bağlam olarak hatırlanır. no_change onayları ve görünür bildirimler bu şekilde depolanmaz.
• Heartbeat çalıştırmaları sırasında OpenClaw, yanıtın başında veya sonunda görünen HEARTBEAT_OK değerini onay olarak kabul eder. Belirteç kaldırılır ve kalan içerik en fazla 300 karakterse yanıt bırakılır.
• HEARTBEAT_OK bir yanıtın ortasında görünürse özel olarak işlenmez.
• Uyarılar için HEARTBEAT_OK değerini eklemeyin; yalnızca uyarı metnini döndürün.

​

Yapılandırma

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m", // varsayılan: 30m (0m devre dışı bırakır)
        model: "anthropic/claude-opus-4-6",
        lightContext: false, // varsayılan: false; true, Heartbeat çalıştırmalarında çalışma alanı başlangıç dosyalarını atlar
        isolatedSession: false, // varsayılan: false; true, her Heartbeat'i yeni bir oturumda çalıştırır (konuşma geçmişi yok)
        target: "last", // varsayılan: none | seçenekler: last | none | <channel id> (çekirdek veya Plugin, ör. "imessage")
        to: "+15551234567", // isteğe bağlı kanala özgü geçersiz kılma
        accountId: "ops-bot", // isteğe bağlı çok hesaplı kanal kimliği
        prompt: "Sağlandığında Heartbeat izleyicisinin not bağlamını izleyin. Yinelenen görevler cron işleridir; bunların zamanlamalarını Heartbeat notlarıyla değil, cron araçları veya openclaw cron CLI ile oluşturun ya da değiştirin. Önceki sohbetlerdeki eski görevleri çıkarsamayın veya yinelemeyin. İlgilenilmesi gereken bir şey yoksa HEARTBEAT_OK yanıtını verin.",
      },
    },
  },
}

​

Kapsam ve öncelik

• agents.defaults.heartbeat genel Heartbeat davranışını ayarlar.
• agents.entries.*.heartbeat bunun üzerine birleştirilir; herhangi bir agent’ın heartbeat bloğu varsa Heartbeat’leri yalnızca bu agent’lar çalıştırır.
• channels.defaults.heartbeatVisibility tüm kanallar için görünürlük varsayılanlarını ayarlar.
• channels.<channel>.heartbeatVisibility kanal varsayılanlarını geçersiz kılar.
• channels.<channel>.accounts.<id>.heartbeatVisibility (çok hesaplı kanallar) kanal başına ayarları geçersiz kılar.

​

Agent başına Heartbeat’ler

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last", // son kişiye açıkça teslim et (varsayılan "none")
      },
    },
    list: [
      { id: "main", default: true },
      {
        id: "ops",
        heartbeat: {
          every: "1h",
          target: "whatsapp",
          to: "+15551234567",
          timeoutSeconds: 45,
          prompt: "Sağlandığında Heartbeat izleyicisinin not bağlamını izleyin. Yinelenen görevler cron işleridir; bunların zamanlamalarını Heartbeat notlarıyla değil, cron araçları veya openclaw cron CLI ile oluşturun ya da değiştirin. Önceki sohbetlerdeki eski görevleri çıkarsamayın veya yinelemeyin. İlgilenilmesi gereken bir şey yoksa HEARTBEAT_OK yanıtını verin.",
        },
      },
    ],
  },
}

​

Etkin saatler örneği

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last", // son kişiye açıkça teslim et (varsayılan "none")
        activeHours: {
          start: "09:00",
          end: "22:00",
          timezone: "America/New_York", // isteğe bağlı; ayarlanmışsa userTimezone değerinizi, aksi takdirde ana makinenin saat dilimini kullanır
        },
      },
    },
  },
}

​

24/7 kurulumu

• activeHours öğesini tamamen çıkarın (zaman penceresi kısıtlaması yoktur; varsayılan davranış budur).
• Tam günlük bir pencere ayarlayın: activeHours: { start: "00:00", end: "24:00" }.

​

Çok hesaplı örnek

{
  agents: {
    list: [
      {
        id: "ops",
        heartbeat: {
          every: "1h",
          target: "telegram",
          to: "12345678:topic:42", // isteğe bağlı: belirli bir konuya/iş parçacığına yönlendir
          accountId: "ops-bot",
        },
      },
    ],
  },
  channels: {
    telegram: {
      accounts: {
        "ops-bot": { botToken: "YOUR_TELEGRAM_BOT_TOKEN" },
      },
    },
  },
}

​

Alan notları

​

Teslim davranışı

​

Görünürlük denetimleri

channels:
  defaults:
    heartbeat:
      showOk: false # HEARTBEAT_OK değerini gizle (varsayılan)
      showAlerts: true # Uyarı mesajlarını göster (varsayılan)
      useIndicator: true # Gösterge olayları yayınla (varsayılan)
  telegram:
    heartbeat:
      showOk: true # Telegram'da OK onaylarını göster
  whatsapp:
    accounts:
      work:
        heartbeat:
          showAlerts: false # Bu hesap için uyarı teslimatını engelle

​

Her bayrağın işlevi

• showOk: model yalnızca OK içeren bir yanıt döndürdüğünde HEARTBEAT_OK onayı gönderir.
• showAlerts: model OK olmayan bir yanıt döndürdüğünde uyarı içeriğini gönderir.
• useIndicator: UI durum yüzeyleri için gösterge olayları yayınlar.

​

Kanal ve hesap bazında örnekler

channels:
  defaults:
    heartbeat:
      showOk: false
      showAlerts: true
      useIndicator: true
  slack:
    heartbeat:
      showOk: true # tüm Slack hesapları
    accounts:
      ops:
        heartbeat:
          showAlerts: false # yalnızca ops hesabının uyarılarını engelle
  telegram:
    heartbeat:
      showOk: true

​

Yaygın kalıplar

​

İzleyici karalama alanı (isteğe bağlı)

openclaw cron scratch <jobId>                 # mevcut karalama alanını yazdır
openclaw cron scratch <jobId> --set "..."     # tam metinle değiştir
openclaw cron scratch <jobId> --file notes.md # bir dosyadan değiştir (stdin için -)
openclaw cron scratch <jobId> --unset         # kaldır

# Heartbeat kontrol listesi

- Hızlı tarama: gelen kutularında acil bir şey var mı?
- Gündüzse ve bekleyen başka bir şey yoksa kısa bir yoklama yap.
- Bir görev engellenmişse _neyin eksik olduğunu_ yaz ve bir dahaki sefere Peter'a sor.

​

Yinelenen kontrolleri cron ile zamanlayın

​

Ajan kendi karalama alanını güncelleyebilir mi?

​

Manuel uyandırma (isteğe bağlı)

openclaw system event --text "Acil takipleri kontrol et" --mode now

openclaw system heartbeat last     # son Heartbeat olayını göster
openclaw system heartbeat enable   # Heartbeat'leri etkinleştir
openclaw system heartbeat disable  # Heartbeat'leri devre dışı bırak

​

Maliyet bilinci

• Tam konuşma geçmişini göndermekten kaçınmak için isolatedSession: true kullanın (çalıştırma başına ~100K tokendan ~2-5K tokene).
• Heartbeat çalıştırmalarında çalışma alanı başlangıç dosyalarını atlamak için lightContext: true kullanın.
• Daha ucuz bir model ayarlayın (ör. ollama/llama3.2:1b).
• İzleyici karalama alanını küçük tutun.
• Yalnızca iç durum güncellemelerini istiyorsanız target: "none" kullanın.

​

Heartbeat sonrası bağlam taşması

​

İlgili

• Otomasyon - tüm otomasyon mekanizmalarına genel bakış
• Arka Plan Görevleri - ayrılmış işlerin nasıl izlendiği
• Saat Dilimi - saat diliminin Heartbeat zamanlamasını nasıl etkilediği
• Sorun Giderme - otomasyon sorunlarını ayıklama