Arka plan görevleri

Arka plan görevleri, ana konuşma oturumunuzun dışında çalışan işleri izler: ACP çalıştırmaları, alt aracı başlatmaları, yalıtılmış 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 ayrılmış işin ne zaman gerçekleştiğini ve başarılı olup olmadığını kaydeden etkinlik defteridir.

Özet

• Görevler kayıttır, zamanlayıcı değildir; cron ve Heartbeat işin ne zaman çalışacağını belirler, görevler ise ne olduğunu izler.
• ACP, alt aracılar, tüm cron işleri ve CLI işlemleri görev oluşturur. Heartbeat turları oluşturmaz.
• Her görev queued → running → terminal sürecinden geçer (succeeded, failed, timed_out, cancelled veya lost).
• Cron çalışma zamanı işi hâlâ sahiplenirken cron görevleri canlı kalır; bellek içi çalışma zamanı durumu kaybolursa görev bakımı, bir görevi lost olarak işaretlemeden önce kalıcı cron çalışma geçmişini kontrol eder.
• Tamamlanma push odaklıdır: ayrılmış iş doğrudan bildirim gönderebilir veya bittiğinde istekte bulunan oturumu/Heartbeat’i uyandırabilir; bu nedenle durum yoklama döngüleri genellikle yanlış biçimdir.
• Yalıtılmış cron çalıştırmaları ve alt aracı tamamlanmaları, son temizlik kayıtlarından önce alt oturumları için izlenen tarayıcı sekmelerini/süreçlerini en iyi çabayla temizler.
• Yalıtılmış cron teslimi, alt alt aracı işi hâlâ boşalırken eski ara üst yanıtları bastırır ve teslimden önce geldiğinde son alt çıktıyı tercih eder.
• Tamamlanma bildirimleri doğrudan bir kanala teslim edilir veya bir sonraki Heartbeat için sıraya alınır.
• openclaw tasks list tüm görevleri gösterir; openclaw tasks audit sorunları yüzeye çıkarır.
• Terminal kayıtları 7 gün tutulur, ardından otomatik olarak budanır.

Hızlı başlangıç

# List all tasks (newest first)openclaw tasks list # Filter by runtime or statusopenclaw tasks list --runtime acpopenclaw tasks list --status running

# Show details for a specific task (by ID, run ID, or session key)openclaw tasks show <lookup>

# Cancel a running task (kills the child session)openclaw tasks cancel <lookup> # Change notification policy for a taskopenclaw tasks notify <lookup> state_changes

# Run a health auditopenclaw tasks audit # Preview or apply maintenanceopenclaw tasks maintenanceopenclaw tasks maintenance --apply

# Inspect TaskFlow stateopenclaw tasks flow listopenclaw tasks flow show <lookup>openclaw tasks flow cancel <lookup>

Görevi ne 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 aracı çalıştırması sona erdiğinde görev durumu buna uyacak şekilde güncellenir.

Aracı çalıştırmasının tamamlanması, etkin görev kayıtları için yetkilidir. Başarılı bir ayrılmış çalıştırma succeeded olarak, sıradan çalıştırma hataları failed olarak, zaman aşımı veya iptal sonuçları ise 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 sonra gelen başarı sinyali bu terminal durumunu düşürmez.

lost çalışma zamanına duyarlıdır:

• ACP görevleri: dayanak ACP alt oturum meta verileri kayboldu.
• Alt aracı görevleri: dayanak alt oturum, hedef aracı deposundan kayboldu.
• Cron görevleri: cron çalışma zamanı artık işi etkin olarak izlemiyor ve kalıcı cron çalışma geçmişi o çalışma için terminal bir sonuç göstermiyor. Çevrimdışı CLI denetimi, kendi boş süreç içi cron çalışma zamanı durumunu yetkili kabul etmez.
• CLI görevleri: çalışma kimliği/kaynak kimliği olan görevler canlı çalışma bağlamını kullanır; bu nedenle kalan alt oturum veya sohbet oturumu satırları, Gateway’in sahip olduğu çalışma kaybolduktan sonra onları canlı tutmaz. Çalışma kimliği olmayan eski CLI görevleri hâlâ alt oturuma geri döner. Gateway destekli openclaw agent çalıştırmaları da çalışma sonuçlarından sonlandırılır; bu yüzden tamamlanmış çalıştırmalar, süpürücü onları lost olarak işaretleyene kadar etkin 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 (requesterOrigin) varsa tamamlanma mesajı doğrudan o kanala gider (Telegram, Discord, Slack vb.). Grup ve kanal görev tamamlanmaları bunun yerine istekte bulunan oturum üzerinden yönlendirilir; böylece üst aracı görünür yanıtı yazabilir. Alt aracı tamamlanmaları 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: ayrılmış işi bir kez başlatın, ardından çalışma zamanının tamamlanınca 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 ilkeleri

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

Bir görev çalışırken ilkeyi 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 tamamlanan görevleri çalışma zamanı, 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, başka oturum ayrıntılarını sızdırmadan yine de bir genel bakış almanız için ajan 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:

• etkin - queued + running sayısı
• başarısızlıklar - 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ığına sahip bir görev anlık görüntüsü kullanır: etkin görevler tercih edilir, bayat tamamlanmış satırlar gizlenir ve yakın tarihli başarısızlıklar yalnızca etkin iş kalmadığında yüzeye çıkar. Bu, durum kartını şu anda önemli olana odaklı tutar.

Depolama ve bakım

Görevlerin yaşadığı yer

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

$OPENCLAW_STATE_DIR/tasks/runs.sqlite

Kayıt, Gateway başlangıcında belleğe yüklenir ve yeniden başlatmalar arasında dayanıklılık için yazımları SQLite ile eşitler. Gateway, SQLite'ın varsayılan otomatik kontrol noktası eşiğini ve periyodik PASSIVE kontrol noktalarını kullanarak SQLite write-ahead log boyutunu sınırlı tutar. Kapatma ve açık bakım kontrol noktaları yine TRUNCATE kullanır; böylece normal kapanışlar, arka plan süpürücüsünü etkin okuyucuları bekletmeden WAL alanını geri kazanabilir.

Otomatik bakım

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

Görevler diğer sistemlerle nasıl ilişkilidir

İlgili

• Otomasyon - tüm otomasyon mekanizmalarına bir bakış
• CLI: Görevler - CLI komut başvurusu
• Heartbeat - periyodik ana oturum turları
• Zamanlanmış Görevler - arka plan işi zamanlama
• Görev Akışı - görevlerin üstündeki akış düzenleme