Arka planda yürütme ve süreç aracı

OpenClaw, kabuk komutlarını exec aracı üzerinden çalıştırır ve uzun süre çalışan görevleri bellekte tutar. process aracı bu arka plan oturumlarını yönetir.

exec aracı

Parametreler:

Davranış:

• Ön plandaki çalıştırmalar çıktıyı doğrudan döndürür.
• Arka plana alındığında (açıkça veya yieldMs zaman aşımıyla), araç status: "running" + sessionId ve çıktının kısa bir son bölümünü döndürür.
• Arka plana alınan ve yieldMs kullanılan çalıştırmalar, çağrıda açık bir timeout belirtilmedikçe tools.exec.timeoutSec değerini devralır.
• Çıktı, oturum yoklanana veya temizlenene kadar bellekte kalır.
• process aracına izin verilmiyorsa exec eşzamanlı çalışır ve yieldMs/background değerlerini yok sayar.
• Başlatılan exec komutları, bağlama duyarlı kabuk/profil kuralları için OPENCLAW_SHELL=exec alır.
• Şimdi başlayan uzun süreli işler için: işi bir kez başlatın ve komut çıktı ürettiğinde veya başarısız olduğunda, etkinse otomatik tamamlanma uyandırmasına güvenin.
• Otomatik tamamlanma uyandırması kullanılamıyorsa veya çıktı üretmeden başarıyla sonlanan bir komut için sessiz başarı onayı gerekiyorsa process ile yoklayın.
• Hatırlatıcıları veya gecikmeli takipleri sleep döngüleriyle ya da tekrarlanan yoklamalarla taklit etmeyin — gelecekteki işler için cron kullanın.

Ortam değişkeni geçersiz kılmaları

Yapılandırma (ortam değişkeni geçersiz kılmalarına tercih edilir)

Alt işlem köprüleme

Exec/process araçlarının dışında uzun süre çalışan alt işlemler başlatırken (CLI'ın yeniden başlatılması, gateway yardımcıları), sonlandırma sinyallerinin iletilmesi ve dinleyicilerin çıkışta/hata durumunda ayrılması için alt işlem köprü yardımcısını ekleyin. Bu, systemd üzerinde yetim işlemleri önler ve kapatmayı platformlar arasında tutarlı kılar.

process aracı

Eylemler:

Notlar:

• Yalnızca arka plana alınmış oturumlar listelenir/kalıcı tutulur — yalnızca bellekte, diskte değil. İşlem yeniden başlatıldığında oturumlar kaybolur.
• Canlı bir arka plan oturumu, işlem sahibi gerçek çıkışı onaylayana kadar işbirlikçi ana makine askıya almayı ve güvenli Gateway yeniden başlatmasını engeller.
• process remove, sonlandırma isteğinin hemen ardından çalışan bir oturumu gizleyebilir; askıya alma ve yeniden başlatma, çıkış onaylanana kadar engellenmeye devam eder.
• Oturum günlükleri yalnızca process poll/log çalıştırıldığında ve araç sonucu sohbet geçmişine kaydedildiğinde sohbet geçmişine eklenir.
• process ajan başına kapsamlandırılmıştır; yalnızca o ajan tarafından başlatılan oturumları görür.
• Otomatik tamamlanma uyandırması kullanılamadığında durum, günlükler veya tamamlanma onayı için poll/log kullanın.
• Etkileşimli bir CLI'ı kurtarmadan önce log kullanın; böylece mevcut döküm, stdin durumu ve girdi bekleme ipucu birlikte görünür.
• Girdi veya müdahale gerektiğinde write/send-keys/submit/paste/kill kullanın.
• process list, hızlı taramalar için türetilmiş bir name (komut fiili + hedef) içerir.
• process list, poll ve log, yalnızca oturumun hâlâ yazılabilir stdin'i olduğunda ve girdi bekleme eşiğinden (varsayılan 15000 ms, OPENCLAW_PROCESS_INPUT_WAIT_IDLE_MS) daha uzun süredir boşta olduğunda waitingForInput bildirir.
• process log, satır tabanlı offset/limit kullanır. Her ikisi de atlandığında, sayfalama ipucuyla birlikte son 200 satırı döndürür. offset ayarlanıp limit ayarlanmadığında, offset değerinden sona kadar döndürür (200 ile sınırlandırılmaz).
• poll için timeout, dönmeden önce en fazla belirtilen milisaniye kadar bekler; 30000 üzerindeki değerler 30000 ile sınırlandırılır.
• Yoklama, isteğe bağlı durum denetimi içindir; bekleme döngüsü zamanlaması için değildir. İş daha sonra yapılacaksa cron kullanın.

Örnekler

Uzun bir görev çalıştırıp daha sonra yoklayın:

{ "tool": "exec", "command": "sleep 5 && echo done", "yieldMs": 1000 }

{ "tool": "process", "action": "poll", "sessionId": "<id>" }

Girdi göndermeden önce etkileşimli bir oturumu inceleyin:

{ "tool": "process", "action": "log", "sessionId": "<id>" }

Hemen arka planda başlatın:

{ "tool": "exec", "command": "npm run build", "background": true }

stdin gönderin:

{ "tool": "process", "action": "write", "sessionId": "<id>", "data": "y\n" }

PTY tuşlarını gönderin:

{ "tool": "process", "action": "send-keys", "sessionId": "<id>", "keys": ["C-c"] }

Geçerli satırı gönderin:

{ "tool": "process", "action": "submit", "sessionId": "<id>" }

Düz metin yapıştırın:

{ "tool": "process", "action": "paste", "sessionId": "<id>", "text": "line1\nline2\n" }

İlgili

• Exec aracı
• Exec onayları