Uitvoering op de achtergrond en procestool

OpenClaw voert shellopdrachten uit via de tool exec en bewaart langlopende taken in het geheugen. De tool process beheert deze achtergrondsessies.

Tool exec

Parameters:

Gedrag:

• Uitvoeringen op de voorgrond retourneren de uitvoer rechtstreeks.
• Wanneer een taak naar de achtergrond gaat (expliciet of door een yieldMs-time-out), retourneert de tool status: "running" + sessionId en een kort laatste deel van de uitvoer.
• Uitvoeringen op de achtergrond en met yieldMs nemen tools.exec.timeoutSec over, tenzij de aanroep een expliciete timeout meegeeft.
• Uitvoer blijft in het geheugen totdat de sessie wordt opgevraagd of gewist.
• Als de tool process niet is toegestaan, wordt exec synchroon uitgevoerd en worden yieldMs/background genegeerd.
• Gestarte exec-opdrachten ontvangen OPENCLAW_SHELL=exec voor contextbewuste shell-/profielregels.
• Voor langlopend werk dat nu begint: start het eenmaal en vertrouw op de automatische activering bij voltooiing (indien ingeschakeld) zodra de opdracht uitvoer produceert of mislukt.
• Als automatische activering bij voltooiing niet beschikbaar is, of als je bevestiging van een stille succesvolle uitvoering nodig hebt voor een opdracht die zonder uitvoer correct afsluit, vraag je de status op met process.
• Boots herinneringen of uitgestelde vervolgacties niet na met sleep-lussen of herhaald opvragen — gebruik Cron voor toekomstig werk.

Overschrijvingen via omgevingsvariabelen

Configuratie (bij voorkeur in plaats van overschrijvingen via omgevingsvariabelen)

Overbrugging van onderliggende processen

Wanneer langlopende onderliggende processen buiten de tools exec/process worden gestart (herstarts van CLI's, Gateway-helpers), koppel je de overbruggingshelper voor onderliggende processen zodat beëindigingssignalen worden doorgestuurd en listeners bij afsluiten/fouten worden losgekoppeld. Dit voorkomt verweesde processen onder systemd en houdt het afsluitgedrag consistent op verschillende platforms.

Tool process

Acties:

Opmerkingen:

• Alleen achtergrondsessies worden weergegeven/bewaard — uitsluitend in het geheugen, niet op schijf. Sessies gaan verloren wanneer het proces opnieuw wordt gestart.
• Een actieve achtergrondsessie blokkeert coöperatieve opschorting van de host en een veilige herstart van de Gateway totdat de proceseigenaar bevestigt dat het proces daadwerkelijk is afgesloten.
• process remove kan een actieve sessie onmiddellijk verbergen nadat beëindiging is aangevraagd; opschorting en herstart blijven geblokkeerd totdat het afsluiten is bevestigd.
• Sessielogboeken worden alleen in de chatgeschiedenis opgeslagen als je process poll/log uitvoert en het toolresultaat wordt vastgelegd.
• process heeft een bereik per agent; de tool ziet alleen sessies die door die agent zijn gestart.
• Gebruik poll/log voor status, logboeken of bevestiging van voltooiing wanneer automatische activering bij voltooiing niet beschikbaar is.
• Gebruik log voordat je een interactieve CLI herstelt, zodat het huidige transcript, de stdin-status en de aanwijzing dat op invoer wordt gewacht samen zichtbaar zijn.
• Gebruik write/send-keys/submit/paste/kill wanneer invoer of ingrijpen nodig is.
• process list bevat een afgeleide name (opdrachtwerkwoord + doel) voor snel overzicht.
• process list, poll en log rapporteren waitingForInput alleen wanneer de sessie nog schrijfbare stdin heeft en langer inactief is dan de drempel voor wachten op invoer (standaard 15000 ms, OPENCLAW_PROCESS_INPUT_WAIT_IDLE_MS).
• process log gebruikt een regelgebaseerde offset/limit. Wanneer beide zijn weggelaten, worden de laatste 200 regels geretourneerd met een bladeraanwijzing. Wanneer offset is ingesteld en limit niet, wordt vanaf offset tot het einde geretourneerd (niet beperkt tot 200).
• De timeout van poll wacht maximaal het opgegeven aantal milliseconden voordat de aanroep retourneert; waarden boven 30000 worden begrensd op 30000.
• Opvragen is bedoeld voor status op aanvraag, niet voor het plannen van wachtlussen. Als het werk later moet plaatsvinden, gebruik je Cron.

Voorbeelden

Voer een langlopende taak uit en vraag de status later op:

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

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

Inspecteer een interactieve sessie voordat je invoer verstuurt:

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

Start onmiddellijk op de achtergrond:

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

Stuur stdin:

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

Stuur PTY-toetsen:

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

Verstuur de huidige regel:

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

Plak letterlijke tekst:

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

Gerelateerd

• Tool exec
• Goedkeuringen voor exec