Herramienta de ejecución en segundo plano y procesos

​

herramienta exec

• Las ejecuciones en primer plano devuelven la salida directamente.
• Cuando se envía al segundo plano (explícitamente o mediante el tiempo de espera de yieldMs), la herramienta devuelve status: "running" + sessionId y una cola breve de salida.
• Las ejecuciones en segundo plano y con yieldMs heredan tools.exec.timeoutSec salvo que la llamada pase un timeout explícito.
• La salida permanece en memoria hasta que se sondea o se borra la sesión.
• Si la herramienta process no está permitida, exec se ejecuta de forma síncrona e ignora yieldMs/background.
• Los comandos exec generados reciben OPENCLAW_SHELL=exec para reglas de shell/perfil conscientes del contexto.
• Para trabajo de larga duración que empieza ahora: inícialo una vez y confía en la activación automática al completarse (cuando esté habilitada) una vez que el comando emita salida o falle.
• Si la activación automática al completarse no está disponible, o necesitas confirmar éxito silencioso para un comando que sale correctamente sin salida, sondea con process.
• No emules recordatorios ni seguimientos diferidos con bucles sleep o sondeos repetidos; usa cron para trabajo futuro.

​

Sobrescrituras de entorno

​

Configuración (preferida sobre las sobrescrituras de entorno)

​

Puente de procesos hijos

​

herramienta process

• Solo se listan/persisten las sesiones en segundo plano: únicamente en memoria, no en disco. Las sesiones se pierden al reiniciar el proceso.
• Los registros de sesión solo se guardan en el historial de chat si ejecutas process poll/log y se registra el resultado de la herramienta.
• process tiene alcance por agente; solo ve las sesiones iniciadas por ese agente.
• Usa poll/log para estado, registros o confirmación de finalización cuando la activación automática al completarse no esté disponible.
• Usa log antes de recuperar una CLI interactiva, para que la transcripción actual, el estado de stdin y la pista de espera de entrada sean visibles juntos.
• Usa write/send-keys/submit/paste/kill cuando necesites entrada o intervención.
• process list incluye un name derivado (verbo del comando + destino) para revisiones rápidas.
• process list, poll y log informan waitingForInput solo cuando la sesión todavía tiene stdin escribible y ha estado inactiva más tiempo que el umbral de espera de entrada (valor predeterminado: 15000 ms, OPENCLAW_PROCESS_INPUT_WAIT_IDLE_MS).
• process log usa offset/limit basados en líneas. Cuando ambos se omiten, devuelve las últimas 200 líneas con una pista de paginación. Cuando se establece offset y limit no, devuelve desde offset hasta el final (sin limitar a 200).
• El timeout de poll espera hasta esa cantidad de milisegundos antes de devolver; los valores superiores a 30000 se limitan a 30000.
• El sondeo es para estado bajo demanda, no para programar bucles de espera. Si el trabajo debe ocurrir más tarde, usa cron.

​

Ejemplos

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

​

Relacionado

• Herramienta Exec
• Aprobaciones de exec