Arka plan görevleri

Arka plan görevleri, ana konuşma oturumunuzun dışında çalışan işleri izler: ACP çalıştırmaları, alt ajan başlatmaları, izole cron işi yürütmeleri ve CLI tarafından başlatılan işlemler.

Görevler oturumların, cron işlerinin veya heartbeat'lerin yerini almaz; bunlar, hangi bağımsız işin ne zaman gerçekleştiğini ve başarılı olup olmadığını kaydeden etkinlik defteridir.

TL;DR

• Görevler zamanlayıcı değil, kayıtlardır; cron ve heartbeat işin ne zaman çalışacağına karar verir, görevler ne olduğunu izler.
• ACP, alt ajanlar, tüm cron işleri ve CLI işlemleri görev oluşturur. Heartbeat dönüşleri oluşturmaz.
• Her görev queued → running → terminal (succeeded, failed, timed_out, cancelled veya lost) üzerinden ilerler.
• Cron görevleri, cron çalışma zamanı işi hâlâ sahiplenirken canlı kalır; bellek içi çalışma zamanı durumu kaybolduysa görev bakımı, görevi lost olarak işaretlemeden önce dayanıklı cron çalıştırma geçmişini denetler.
• Tamamlama push odaklıdır: bağımsız iş doğrudan bildirebilir veya bittiğinde istekte bulunan oturumu/heartbeat'i uyandırabilir; bu yüzden durum yoklama döngüleri genellikle yanlış biçimdir.
• İzole cron çalıştırmaları ve alt ajan tamamlamaları, son temizlik muhasebesinden önce alt oturumları için izlenen tarayıcı sekmelerini/süreçlerini en iyi çabayla temizler.
• İzole cron teslimi, soy alt ajan işi hâlâ boşalırken eski ara üst yanıtları bastırır ve teslimden önce gelirse son soy çıktısını tercih eder.
• Tamamlama bildirimleri doğrudan bir kanala teslim edilir veya bir sonraki heartbeat için kuyruğa alınır.
• openclaw tasks list tüm görevleri gösterir; openclaw tasks audit sorunları ortaya çıkarır.
• Terminal kayıtları 7 gün tutulur, ardından otomatik olarak budanır.

Hızlı başlangıç

# Tüm görevleri listele (en yeni önce)openclaw tasks list # Çalışma zamanı veya duruma göre filtreleopenclaw tasks list --runtime acpopenclaw tasks list --status running

# Belirli bir görev için ayrıntıları göster (ID, çalıştırma ID'si veya oturum anahtarına göre)openclaw tasks show <lookup>

# Çalışan bir görevi iptal et (alt oturumu sonlandırır)openclaw tasks cancel <lookup> # Bir görev için bildirim politikasını değiştiropenclaw tasks notify <lookup> state_changes

# Sağlık denetimi çalıştıropenclaw tasks audit # Bakımı önizle veya uygulaopenclaw tasks maintenanceopenclaw tasks maintenance --apply

# TaskFlow durumunu inceleopenclaw tasks flow listopenclaw tasks flow show <lookup>openclaw tasks flow cancel <lookup>

Ne görev oluşturur

Görev yaşam döngüsü

stateDiagram-v2
    [*] --> queued
    queued --> running : agent starts
    running --> succeeded : completes ok
    running --> failed : error
    running --> timed_out : timeout exceeded
    running --> cancelled : operator cancels
    queued --> lost : session gone > 5 min
    running --> lost : session gone > 5 min

Geçişler otomatik olarak gerçekleşir; ilişkili ajan çalıştırması bittiğinde görev durumu buna uyacak şekilde güncellenir.

Ajan çalıştırmasının tamamlanması aktif görev kayıtları için belirleyicidir. Başarılı bir bağımsız çalıştırma succeeded olarak sonlandırılır, sıradan çalıştırma hataları failed olarak sonlandırılır ve zaman aşımı veya iptal sonuçları timed_out olarak sonlandırılır. Bir operatör görevi zaten iptal ettiyse veya çalışma zamanı failed, timed_out ya da lost gibi daha güçlü bir terminal durumu zaten kaydettiyse daha sonraki bir başarı sinyali bu terminal durumu düşürmez.

lost çalışma zamanı farkındadır:

• ACP görevleri: destekleyen ACP alt oturum metaverisi kayboldu.
• Alt ajan görevleri: destekleyen alt oturum hedef ajan deposundan kayboldu.
• Cron görevleri: cron çalışma zamanı işi artık aktif olarak izlemiyor ve dayanıklı cron çalıştırma geçmişi bu çalıştırma için terminal bir sonuç göstermiyor. Çevrimdışı CLI denetimi, kendi boş süreç içi cron çalışma zamanı durumunu yetkili saymaz.
• CLI görevleri: çalıştırma ID'si/kaynak ID'si olan görevler canlı çalıştırma bağlamını kullanır; böylece kalıcı alt oturum veya sohbet oturumu satırları, Gateway sahipliğindeki çalıştırma kaybolduktan sonra onları canlı tutmaz. Çalıştırma kimliği olmayan eski CLI görevleri hâlâ alt oturuma geri döner. Gateway destekli openclaw agent çalıştırmaları da çalıştırma sonucundan sonlandırılır; bu nedenle tamamlanan çalıştırmalar süpürücü onları lost olarak işaretleyene kadar aktif kalmaz.

Teslim ve bildirimler

Bir görev terminal duruma ulaştığında OpenClaw sizi bilgilendirir. İki teslim yolu vardır:

Doğrudan teslim - görevde bir kanal hedefi varsa (requesterOrigin), tamamlama mesajı doğrudan o kanala gider (Telegram, Discord, Slack vb.). Grup ve kanal görevi tamamlamaları bunun yerine istekte bulunan oturum üzerinden yönlendirilir; böylece üst ajan görünür yanıtı yazabilir. Alt ajan tamamlamaları için OpenClaw, mevcut olduğunda bağlı iş parçacığı/konu yönlendirmesini de korur ve doğrudan teslimden vazgeçmeden önce eksik bir to / hesabı istekte bulunan oturumun saklanan rotasından (lastChannel / lastTo / lastAccountId) doldurabilir.

Oturum kuyruğuna alınmış teslim - doğrudan teslim başarısız olursa veya origin ayarlanmamışsa güncelleme, istekte bulunanın oturumunda bir sistem olayı olarak kuyruğa alınır ve bir sonraki heartbeat'te görünür.

Bu, olağan iş akışının push tabanlı olduğu anlamına gelir: bağımsız işi bir kez başlatın, sonra çalışma zamanının tamamlandığında sizi uyandırmasına veya bilgilendirmesine izin verin. Görev durumunu yalnızca hata ayıklama, müdahale veya açık bir denetim gerektiğinde yoklayın.

Bildirim politikaları

Her görev hakkında ne kadar duyacağınızı denetleyin:

Bir görev çalışırken politikayı değiştirin:

openclaw tasks notify <lookup> state_changes

CLI başvurusu

openclaw tasks list [--runtime <acp|subagent|cron|cli>] [--status <status>] [--json]

openclaw tasks show <lookup>

openclaw tasks cancel <lookup>

openclaw tasks notify <lookup> <done_only|state_changes|silent>

openclaw tasks audit [--json]

openclaw tasks maintenance [--json]openclaw tasks maintenance --apply [--json]

openclaw tasks flow list [--status <status>] [--json]openclaw tasks flow show <lookup> [--json]openclaw tasks flow cancel <lookup>

Sohbet görev panosu (/tasks)

Bu oturuma bağlı arka plan görevlerini görmek için herhangi bir sohbet oturumunda /tasks kullanın. Pano, etkin ve yakın zamanda tamamlanmış görevleri runtime, durum, zamanlama ve ilerleme veya hata ayrıntısıyla gösterir.

Geçerli oturumda görünür bağlı görev yoksa, /tasks diğer oturum ayrıntılarını sızdırmadan yine de bir genel bakış almanız için aracı yerel görev sayılarına geri döner.

Tam operatör defteri için CLI kullanın: openclaw tasks list.

Durum entegrasyonu (görev baskısı)

openclaw status bir bakışta görev özeti içerir:

Tasks: 3 queued · 2 running · 1 issues

Özet şunları bildirir:

• active - queued + running sayısı
• failures - failed + timed_out + lost sayısı
• byRuntime - acp, subagent, cron, cli kırılımı

Hem /status hem de session_status aracı temizleme farkındalığı olan bir görev anlık görüntüsü kullanır: etkin görevler tercih edilir, eski tamamlanmış satırlar gizlenir ve son hatalar yalnızca etkin iş kalmadığında yüzeye çıkar. Bu, durum kartının şu anda önemli olana odaklı kalmasını sağlar.

Depolama ve bakım

Görevlerin bulunduğu yer

Görev kayıtları SQLite içinde şu konumda kalıcıdır:

$OPENCLAW_STATE_DIR/tasks/runs.sqlite

Kayıt defteri Gateway başlangıcında belleğe yüklenir ve yeniden başlatmalar arasında dayanıklılık için yazmaları SQLite ile eşitler. Gateway, SQLite'ın varsayılan autocheckpoint eşiğini ve periyodik ve kapanış TRUNCATE checkpoint'lerini kullanarak SQLite write-ahead log'unu sınırlı tutar.

Otomatik bakım

Bir süpürücü her 60 saniyede çalışır ve dört şeyi ele alır:

Görevlerin diğer sistemlerle ilişkisi

İlgili

• Otomasyon - tüm otomasyon mekanizmalarına bir bakış
• CLI: Görevler - CLI komut başvurusu
• Heartbeat - periyodik ana oturum dönüşleri
• Zamanlanmış Görevler - arka plan işini zamanlama
• Task Flow - görevlerin üzerinde akış orkestrasyonu