Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw, görevler, zamanlanmış işler, çıkarılan taahhütler, olay hook’ları ve standing instructions aracılığıyla arka planda iş çalıştırır. Bu sayfa doğru mekanizmayı seçmenize ve bunların birlikte nasıl çalıştığını anlamanıza yardımcı olur.

Hızlı karar kılavuzu

Kullanım durumuÖnerilenNeden
Her gün tam 09.00’da rapor gönderZamanlanmış Görevler (Cron)Kesin zamanlama, yalıtılmış yürütme
Bana 20 dakika içinde hatırlatZamanlanmış Görevler (Cron)Hassas zamanlamalı tek seferlik iş (--at)
Haftalık derin analiz çalıştırZamanlanmış Görevler (Cron)Bağımsız görev, farklı model kullanabilir
Gelen kutusunu her 30 dakikada bir kontrol etHeartbeatDiğer kontrollerle birlikte toplu çalışır, bağlam farkındadır
Yaklaşan etkinlikler için takvimi izleHeartbeatDüzenli farkındalık için doğal uyum
Bahsedilen bir görüşmeden sonra kontrol etÇıkarılan TaahhütlerBellek benzeri takip, kesin hatırlatma isteği yok
Kullanıcı bağlamından sonra nazik bakım kontrolüÇıkarılan TaahhütlerAynı agent ve kanalla sınırlıdır
Bir subagent veya ACP çalıştırmasının durumunu inceleArka Plan GörevleriGörev defteri tüm ayrılmış işleri izler
Ne çalıştı ve ne zaman çalıştı denetleArka Plan Görevleriopenclaw tasks list ve openclaw tasks audit
Çok adımlı araştırma yap, sonra özetleGörev AkışıRevizyon izlemeli kalıcı orkestrasyon
Oturum sıfırlamada bir script çalıştırHook’larOlay odaklıdır, yaşam döngüsü olaylarında tetiklenir
Her tool call’da kod yürütPlugin hook’larıSüreç içi hook’lar tool call’larını yakalayabilir
Yanıtlamadan önce her zaman uyumluluğu kontrol etStanding OrdersHer oturuma otomatik olarak enjekte edilir

Zamanlanmış Görevler (Cron) ve Heartbeat

BoyutZamanlanmış Görevler (Cron)Heartbeat
ZamanlamaKesin (cron ifadeleri, tek seferlik)Yaklaşık (varsayılan her 30 dakikada bir)
Oturum bağlamıYeni (yalıtılmış) veya paylaşılanTam ana oturum bağlamı
Görev kayıtlarıHer zaman oluşturulurHiç oluşturulmaz
TeslimatKanal, webhook veya sessizAna oturum içinde
En uygun olduğu işlerRaporlar, hatırlatmalar, arka plan işleriGelen kutusu kontrolleri, takvim, bildirimler
Kesin zamanlamaya veya yalıtılmış yürütmeye ihtiyacınız olduğunda Zamanlanmış Görevler (Cron) kullanın. İş tam oturum bağlamından yararlandığında ve yaklaşık zamanlama yeterli olduğunda Heartbeat kullanın.

Temel kavramlar

Zamanlanmış görevler (cron)

Cron, kesin zamanlama için Gateway’in yerleşik zamanlayıcısıdır. İşleri kalıcı hale getirir, agent’ı doğru zamanda uyandırır ve çıktıyı bir sohbet kanalına veya webhook uç noktasına teslim edebilir. Tek seferlik hatırlatmaları, yinelenen ifadeleri ve gelen webhook tetikleyicilerini destekler. Bkz. Zamanlanmış Görevler.

Görevler

Arka plan görev defteri tüm ayrılmış işleri izler: ACP çalıştırmaları, subagent başlatmaları, yalıtılmış cron yürütmeleri ve CLI işlemleri. Görevler kayıttır, zamanlayıcı değildir. Bunları incelemek için openclaw tasks list ve openclaw tasks audit kullanın. Bkz. Arka Plan Görevleri.

Çıkarılan taahhütler

Taahhütler, isteğe bağlı ve kısa ömürlü takip bellekleridir. OpenClaw bunları normal konuşmalardan çıkarır, aynı agent ve kanalla sınırlar ve zamanı gelen kontrol görüşlerini heartbeat üzerinden teslim eder. Kullanıcının açıkça istediği kesin hatırlatmalar hâlâ cron’a aittir. Bkz. Çıkarılan Taahhütler.

Görev Akışı

Görev Akışı, arka plan görevlerinin üzerindeki akış orkestrasyonu altyapısıdır. Yönetilen ve yansıtılmış eşitleme modları, revizyon izleme ve inceleme için openclaw tasks flow list|show|cancel ile kalıcı çok adımlı akışları yönetir. Bkz. Görev Akışı.

Standing orders

Standing orders, tanımlı programlar için agent’a kalıcı işletim yetkisi verir. Çalışma alanı dosyalarında (genellikle AGENTS.md) bulunur ve her oturuma enjekte edilir. Zamana dayalı uygulama için cron ile birleştirin. Bkz. Standing Orders.

Hook’lar

Dahili hook’lar agent yaşam döngüsü olayları (/new, /reset, /stop), oturum compaction’ı, gateway başlangıcı ve mesaj akışı tarafından tetiklenen olay odaklı script’lerdir. Dizinlerden otomatik olarak keşfedilirler ve openclaw hooks ile yönetilebilirler. Süreç içi tool-call yakalama için Plugin hook’ları kullanın. Bkz. Hook’lar.

Heartbeat

Heartbeat, düzenli bir ana oturum turudur (varsayılan her 30 dakikada bir). Birden fazla kontrolü (gelen kutusu, takvim, bildirimler) tam oturum bağlamıyla tek bir agent turunda toplar. Heartbeat turları görev kayıtları oluşturmaz ve günlük/boşta oturum sıfırlama tazeliğini uzatmaz. Küçük bir kontrol listesi için HEARTBEAT.md kullanın veya heartbeat içinde yalnızca zamanı gelen düzenli kontroller istediğinizde bir tasks: bloğu kullanın. Boş heartbeat dosyaları empty-heartbeat-file olarak atlanır; yalnızca zamanı gelen görev modu no-tasks-due olarak atlanır. Cron işi etkin veya kuyruğa alınmışken heartbeat’ler ertelenir ve heartbeat.skipWhenBusy, aynı agent’ın oturum anahtarlı subagent’ı veya iç içe hatları meşgulken de agent’ı erteleyebilir. Bkz. Heartbeat.

Birlikte nasıl çalışırlar

  • Cron, kesin zamanlamaları (günlük raporlar, haftalık incelemeler) ve tek seferlik hatırlatmaları işler. Tüm cron yürütmeleri görev kayıtları oluşturur.
  • Heartbeat, rutin izlemeyi (gelen kutusu, takvim, bildirimler) her 30 dakikada bir toplu tek turda işler.
  • Hook’lar, özel script’lerle belirli olaylara (oturum sıfırlamaları, compaction, mesaj akışı) tepki verir. Plugin hook’ları tool call’larını kapsar.
  • Standing orders, agent’a kalıcı bağlam ve yetki sınırları verir.
  • Görev Akışı, tekil görevlerin üzerindeki çok adımlı akışları koordine eder.
  • Görevler, tüm ayrılmış işleri otomatik olarak izler; böylece bunları inceleyebilir ve denetleyebilirsiniz.

İlgili