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ı, 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 yerine geçmez; bunlar, hangi ayrık işin ne zaman gerçekleştiğini ve başarılı olup olmadığını kaydeden etkinlik defteridir.

# Kısa özet

• Görevler zamanlayıcı değil, kayıtlardır; Cron ve Heartbeat işin ne zaman çalışacağını belirler, görevler ne olduğunu izler.
• ACP, alt ajanlar, tüm Cron işleri ve CLI işlemleri görev oluşturur. Heartbeat turları oluşturmaz.
• Her görev queued → running → terminal aşamalarından geçer (succeeded, failed, timed_out, cancelled veya lost).
• Cron görevleri, Cron çalışma zamanı hâlâ işi sahipleniyorsa canlı kalır; bellek içi çalışma zamanı durumu kaybolduysa, görev bakımı bir görevi lost olarak işaretlemeden önce dayanıklı Cron çalıştırma geçmişini kontrol eder.
• Tamamlanma push odaklıdır: ayrık iş bittiğinde doğrudan bildirim gönderebilir veya istekte bulunan oturumu/Heartbeat'i uyandırabilir; bu yüzden durum yoklama döngüleri genellikle yanlış biçimdir.
• Yalıtılmış Cron çalıştırmaları ve alt ajan 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 soy alt ajan işi hâlâ boşalırken eskimiş geçici üst yanıtları bastırır ve teslimden önce geldiğinde nihai alt soy çıktısını tercih eder.
• Tamamlanma 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ıç

# List all tasks (newest first)
openclaw tasks list

# Filter by runtime or status
openclaw tasks list --runtime acp
openclaw 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 task
openclaw tasks notify <lookup> state_changes

# Run a health audit
openclaw tasks audit

# Preview or apply maintenance
openclaw tasks maintenance
openclaw tasks maintenance --apply

# Inspect TaskFlow state
openclaw tasks flow list
openclaw 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ı sona erdiğinde görev durumu buna uyacak şekilde güncellenir.

Ajan çalıştırmasının tamamlanması, etkin görev kayıtları için yetkilidir. Başarılı bir ayrık çalıştırma succeeded olarak sonlandırılır, sıradan çalıştırma hataları failed olarak sonlandırılır, 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 sonra gelen başarı sinyali bu terminal durumunu düşürmez.

lost çalışma zamanı bilincine sahiptir:

• ACP görevleri: destekleyen ACP alt oturum meta verisi kayboldu.
• Alt ajan görevleri: destekleyen alt oturum hedef ajan deposundan kayboldu.
• Cron görevleri: Cron çalışma zamanı işi artık etkin olarak izlemiyor ve dayanıklı Cron çalıştırma geçmişi o ç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 olarak değerlendirmez.
• CLI görevleri: yalıtılmış alt oturum görevleri alt oturumu kullanır; sohbet destekli CLI görevleri ise bunun yerine canlı çalıştırma bağlamını kullanır, bu yüzden kalan kanal/grup/doğrudan oturum satırları onları canlı tutmaz. Gateway destekli openclaw agent çalıştırmaları da kendi çalıştırma sonucundan sonlandırılır, bu yüzden tamamlanan ç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örevin bir kanal hedefi varsa (requesterOrigin), tamamlanma mesajı doğrudan o kanala gider (Telegram, Discord, Slack vb.). Alt ajan tamamlanmaları için OpenClaw, varsa bağlı ileti dizisi/konu yönlendirmesini de korur ve doğrudan teslimden vazgeçmeden önce istekte bulunan oturumun saklanan rotasından (lastChannel / lastTo / lastAccountId) eksik bir to / hesabı doldurabilir.

Oturum kuyruğuna alınmış teslim - doğrudan teslim başarısız olursa veya kaynak 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ık işi bir kez başlatın, ardından çalışma zamanının tamamlanınca sizi uyandırmasına veya bildirmesine 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 haber alacağınızı denetleyin:

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

openclaw tasks notify <lookup> state_changes

# CLI referansı

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 ya da hata ayrıntısıyla gösterir.

Geçerli oturumda görünür bağlı görev olmadığında, /tasks ajan yerel görev sayılarına geri döner; böylece diğer oturumların ayrıntılarını sızdırmadan yine de bir genel bakış elde edersiniz.

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 bazında döküm

Hem /status hem de session_status aracı temizliğe duyarlı bir görev anlık görüntüsü kullanır: etkin görevler tercih edilir, eski tamamlanmış satırlar gizlenir ve son başarısızlıklar yalnızca etkin iş kalmadığında gösterilir. Bu, durum kartını şu anda önemli olana odaklı tutar.

# Depolama ve bakım

# Görevlerin bulunduğu yer

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

$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 varsayılan otomatik denetim noktası eşiğini ve düzenli/kapanış TRUNCATE denetim noktalarını kullanarak SQLite write-ahead log boyutunu sınırlı tutar.

# Otomatik bakım

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

# Görevlerin diğer sistemlerle ilişkisi

# İlgili

• Otomasyon ve Görevler - tüm otomasyon mekanizmalarına bir bakış
• CLI: Görevler - CLI komut başvurusu
• Heartbeat - düzenli ana oturum turları
• Zamanlanmış Görevler - arka plan işini zamanlama
• Task Flow - görevlerin üzerindeki akış düzenleme