Esecuzione in background e strumento per i processi

​

Strumento exec

• Le esecuzioni in primo piano restituiscono direttamente l’output.
• Quando l’esecuzione passa in background (esplicitamente o allo scadere di yieldMs), lo strumento restituisce status: "running" + sessionId e una breve parte finale dell’output.
• Le esecuzioni in background e quelle con yieldMs ereditano tools.exec.timeoutSec, a meno che la chiamata non specifichi un timeout esplicito.
• L’output rimane in memoria finché la sessione non viene interrogata o cancellata.
• Se lo strumento process non è consentito, exec viene eseguito in modo sincrono e ignora yieldMs/background.
• I comandi exec avviati ricevono OPENCLAW_SHELL=exec per le regole di shell/profilo sensibili al contesto.
• Per un’attività di lunga durata che inizia ora: avviarla una sola volta e affidarsi alla riattivazione automatica al completamento (se abilitata) quando il comando produce output o non riesce.
• Se la riattivazione automatica al completamento non è disponibile, oppure è necessaria la conferma di un completamento senza output per un comando che termina correttamente, interrogare lo stato con process.
• Non simulare promemoria o operazioni successive differite con cicli sleep o interrogazioni ripetute: usare Cron per le attività future.

​

Sostituzioni tramite variabili di ambiente

​

Configurazione (preferibile alle sostituzioni tramite variabili di ambiente)

​

Collegamento dei processi figlio

​

Strumento process

• Vengono elencate e conservate solo le sessioni in background, esclusivamente in memoria e non su disco. Le sessioni vengono perse al riavvio del processo.
• Una sessione in background attiva impedisce la sospensione cooperativa dell’host e il riavvio sicuro del Gateway finché il proprietario del processo non ne conferma l’effettiva terminazione.
• process remove può nascondere immediatamente una sessione in esecuzione dopo averne richiesto la terminazione; la sospensione e il riavvio rimangono bloccati finché la terminazione non viene confermata.
• I registri delle sessioni vengono salvati nella cronologia della chat solo se si esegue process poll/log e il risultato dello strumento viene registrato.
• process ha un ambito per agente; vede solo le sessioni avviate da quell’agente.
• Usare poll/log per ottenere lo stato, i registri o la conferma del completamento quando la riattivazione automatica al completamento non è disponibile.
• Usare log prima di ripristinare una CLI interattiva, in modo da visualizzare insieme la trascrizione corrente, lo stato di stdin e l’indicazione di attesa dell’input.
• Usare write/send-keys/submit/paste/kill quando sono necessari input o interventi.
• process list include un name derivato (verbo del comando + destinazione) per una rapida consultazione.
• process list, poll e log segnalano waitingForInput solo quando la sessione dispone ancora di stdin scrivibile ed è inattiva da un periodo superiore alla soglia di attesa dell’input (valore predefinito: 15000 ms, OPENCLAW_PROCESS_INPUT_WAIT_IDLE_MS).
• process log usa offset/limit basati sulle righe. Quando entrambi sono omessi, restituisce le ultime 200 righe con un suggerimento per la paginazione. Quando offset è impostato e limit non lo è, restituisce da offset fino alla fine (senza il limite di 200).
• Il timeout di poll attende fino al numero specificato di millisecondi prima di restituire il risultato; i valori superiori a 30000 vengono limitati a 30000.
• L’interrogazione serve per ottenere lo stato su richiesta, non per pianificare cicli di attesa. Se l’attività deve essere eseguita in un secondo momento, usare Cron.

​

Esempi

{ "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" }

​

Contenuti correlati

• Strumento Exec
• Approvazioni Exec