Eksekusi latar belakang dan alat proses

​

Alat exec

• Proses latar depan mengembalikan keluaran secara langsung.
• Saat dialihkan ke latar belakang (secara eksplisit atau karena batas waktu yieldMs), alat mengembalikan status: "running" + sessionId dan cuplikan singkat keluaran terakhir.
• Proses yang berjalan di latar belakang dan proses yieldMs mewarisi tools.exec.timeoutSec, kecuali pemanggilan meneruskan timeout secara eksplisit.
• Keluaran tetap berada dalam memori hingga sesi diperiksa atau dibersihkan.
• Jika alat process tidak diizinkan, exec berjalan secara sinkron dan mengabaikan yieldMs/background.
• Perintah exec yang dibuat menerima OPENCLAW_SHELL=exec untuk aturan shell/profil yang peka konteks.
• Untuk pekerjaan jangka panjang yang dimulai sekarang: mulai sekali dan andalkan pengaktifan otomatis saat selesai (jika diaktifkan) ketika perintah menghasilkan keluaran atau gagal.
• Jika pengaktifan otomatis saat selesai tidak tersedia, atau Anda memerlukan konfirmasi keberhasilan tanpa keluaran untuk perintah yang berakhir dengan baik tanpa keluaran, lakukan pemeriksaan dengan process.
• Jangan meniru pengingat atau tindak lanjut tertunda dengan perulangan sleep atau pemeriksaan berulang — gunakan Cron untuk pekerjaan mendatang.

​

Penggantian melalui variabel lingkungan

​

Konfigurasi (lebih disarankan daripada penggantian melalui variabel lingkungan)

​

Penghubungan proses anak

​

Alat process

• Hanya sesi latar belakang yang dicantumkan/disimpan — hanya dalam memori, bukan pada disk. Sesi hilang saat proses dimulai ulang.
• Sesi latar belakang aktif mencegah penangguhan host secara kooperatif dan mulai ulang Gateway yang aman hingga pemilik proses mengonfirmasi bahwa proses benar-benar telah berhenti.
• process remove dapat langsung menyembunyikan sesi yang sedang berjalan setelah meminta penghentian; penangguhan dan mulai ulang tetap terblokir hingga keluarnya proses dikonfirmasi.
• Log sesi hanya disimpan ke riwayat obrolan jika Anda menjalankan process poll/log dan hasil alat direkam.
• process memiliki cakupan per agen; alat ini hanya melihat sesi yang dimulai oleh agen tersebut.
• Gunakan poll/log untuk status, log, atau konfirmasi penyelesaian saat pengaktifan otomatis ketika selesai tidak tersedia.
• Gunakan log sebelum memulihkan CLI interaktif agar transkrip saat ini, status stdin, dan petunjuk menunggu masukan terlihat bersama-sama.
• Gunakan write/send-keys/submit/paste/kill saat Anda memerlukan masukan atau intervensi.
• process list menyertakan name turunan (kata kerja perintah + target) untuk pemindaian cepat.
• process list, poll, dan log melaporkan waitingForInput hanya ketika sesi masih memiliki stdin yang dapat ditulisi dan telah tidak aktif lebih lama daripada ambang tunggu masukan (bawaan 15000 md, OPENCLAW_PROCESS_INPUT_WAIT_IDLE_MS).
• process log menggunakan offset/limit berbasis baris. Jika keduanya diabaikan, alat mengembalikan 200 baris terakhir beserta petunjuk paginasi. Jika offset ditetapkan dan limit tidak ditetapkan, alat mengembalikan dari offset hingga akhir (tidak dibatasi hingga 200).
• timeout milik poll menunggu hingga jumlah milidetik tersebut sebelum mengembalikan hasil; nilai di atas 30000 dibatasi menjadi 30000.
• Pemeriksaan digunakan untuk status sesuai permintaan, bukan penjadwalan perulangan tunggu. Jika pekerjaan harus dilakukan nanti, gunakan Cron.

​

Contoh

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

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

{ "tool": "process", "action": "log", "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" }

​

Terkait

• Alat Exec
• Persetujuan Exec