​

Arka Plan Exec + Process Aracı

​

exec aracı

• command (zorunlu)
• yieldMs (varsayılan 10000): bu gecikmeden sonra otomatik olarak arka plana alır
• background (bool): hemen arka plana al
• timeout (saniye, varsayılan 1800): bu zaman aşımından sonra süreci sonlandır
• elevated (bool): elevated mode etkinse/izin veriliyorsa sandbox dışında çalıştır (exec hedefi node olduğunda varsayılan olarak gateway veya node)
• Gerçek bir TTY mi gerekiyor? pty: true ayarlayın.
• workdir, env

• Ön plan çalıştırmaları çıktıyı doğrudan döndürür.
• Arka plana alındığında (açıkça veya zaman aşımıyla), araç status: "running" + sessionId ve kısa bir tail döndürür.
• Çıktı, oturum yoklanana veya temizlenene kadar bellekte tutulur.
• 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ı shell/profile 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 etkin olduğunda komut çıktı ürettiğinde veya başarısız olduğunda otomatik tamamlama uyandırmasına güvenin.
• Otomatik tamamlama uyandırması kullanılamıyorsa veya çıktı üretmeden temiz şekilde tamamlanan bir komut için sessiz başarı onayı gerekiyorsa, tamamlanmayı doğrulamak için process kullanın.
• sleep döngüleri veya tekrarlanan yoklama ile hatırlatıcıları ya da gecikmeli takipleri taklit etmeyin; gelecekteki işler için cron kullanın.

​

Alt süreç köprüleme

• PI_BASH_YIELD_MS: varsayılan yield (ms)
• PI_BASH_MAX_OUTPUT_CHARS: bellek içi çıktı sınırı (karakter)
• OPENCLAW_BASH_PENDING_MAX_OUTPUT_CHARS: akış başına bekleyen stdout/stderr sınırı (karakter)
• PI_BASH_JOB_TTL_MS: tamamlanmış oturumlar için TTL (ms, 1 dk–3 sa ile sınırlı)

• tools.exec.backgroundMs (varsayılan 10000)
• tools.exec.timeoutSec (varsayılan 1800)
• tools.exec.cleanupMs (varsayılan 1800000)
• tools.exec.notifyOnExit (varsayılan true): arka plana alınmış bir exec çıktığında bir sistem olayı kuyruğa ekler + heartbeat ister.
• tools.exec.notifyOnExitEmptySuccess (varsayılan false): true olduğunda, çıktı üretmemiş başarılı arka plan çalıştırmaları için de tamamlama olaylarını kuyruğa ekler.

​

process aracı

• list: çalışan + tamamlanmış oturumlar
• poll: bir oturum için yeni çıktıyı boşaltır (ayrıca çıkış durumunu da bildirir)
• log: birikmiş çıktıyı okur (offset + limit destekler)
• write: stdin gönderir (data, isteğe bağlı eof)
• send-keys: PTY destekli bir oturuma açık anahtar token’ları veya baytlar gönderir
• submit: PTY destekli bir oturuma Enter / carriage return gönderir
• paste: isteğe bağlı olarak bracketed paste mode ile sarılmış düz metin gönderir
• kill: bir arka plan oturumunu sonlandırır
• clear: tamamlanmış bir oturumu bellekten kaldırır
• remove: çalışıyorsa sonlandırır, tamamlanmışsa temizler

• Yalnızca arka plana alınmış oturumlar listelenir/bellekte kalıcı tutulur.
• Süreç yeniden başlatıldığında oturumlar kaybolur (diske kalıcılık yok).
• Oturum günlükleri yalnızca process poll/log çalıştırırsanız ve araç sonucu kaydedilirse sohbet geçmişine kaydedilir.
• process, aracı başına kapsamlıdır; yalnızca o aracı tarafından başlatılan oturumları görür.
• Durum, günlükler, sessiz başarı onayı veya otomatik tamamlama uyandırması kullanılamadığında tamamlama onayı için poll / log kullanın.
• 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 içerir (komut fiili + hedef).
• process log, satır tabanlı offset/limit kullanır.
• Hem offset hem limit atlandığında son 200 satırı döndürür ve sayfalama ipucu içerir.
• offset verilip limit verilmediğinde offset değerinden sona kadar döndürür (200 ile sınırlandırılmaz).
• Yoklama, bekleme döngüsü zamanlaması için değil, isteğe bağlı durum kontrolü içindir. İşin daha sonra yapılması gerekiyorsa bunun yerine cron kullanın.

​

Örnekler

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

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

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

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

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

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

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