> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Bakgrunds-Exec och Processverktyg

# Bakgrunds-Exec + Processverktyg

OpenClaw kör skalkommandon genom verktyget `exec` och håller långvariga uppgifter i minnet. Verktyget `process` hanterar dessa bakgrundssessioner.

## exec-verktyg

Viktiga parametrar:

* `command` (krävs)
* `yieldMs` (standard 10000): bakgrundslägg automatiskt efter denna fördröjning
* `background` (bool): kör i bakgrunden direkt
* `timeout` (sekunder, standard 1800): avsluta processen efter denna timeout
* `elevated` (bool): kör på värden om upphöjt läge är aktiverat/tillåtet
* Behöver du en riktig TTY? Ange `pty: true`.
* `workdir`, `env`

Beteende:

* Körningar i förgrunden returnerar utdata direkt.
* När den körs i bakgrunden (explicit eller via timeout) returnerar verktyget `status: "running"` + `sessionId` samt en kort svans.
* Utdata hålls i minnet tills sessionen pollas eller rensas.
* Om verktyget `process` är otillåtet körs `exec` synkront och ignorerar `yieldMs`/`background`.

## Bryggning av barnprocesser

När du skapar långlivade barnprocesser utanför exekvera/processverktygen (till exempel återuppstår CLI eller gatewayhjälpare), bifoga brohjälparen för barnprocessen så att uppsägningssignalerna vidarebefordras och lyssnarna är fristående vid exit/fel. Detta undviker övergivna processer på systemd och håller avstängningsbeteendet konsekvent över plattformar.

Miljöåsidosättningar:

* `PI_BASH_YIELD_MS`: standard-yield (ms)
* `PI_BASH_MAX_OUTPUT_CHARS`: gräns för utdata i minnet (tecken)
* `OPENCLAW_BASH_PENDING_MAX_OUTPUT_CHARS`: gräns för väntande stdout/stderr per ström (tecken)
* `PI_BASH_JOB_TTL_MS`: TTL för avslutade sessioner (ms, begränsad till 1 m–3 h)

Konfig (föredras):

* `tools.exec.backgroundMs` (standard 10000)
* `tools.exec.timeoutSec` (standard 1800)
* `tools.exec.cleanupMs` (standard 1800000)
* `tools.exec.notifyOnExit` (standard true): köa en systemhändelse + begär hjärtslag när en bakgrundsexekvering avslutas.
* `tools.exec.notifyOnExitEmptySuccess` (standard false): när true köas även slutförandehändelser för lyckade bakgrundskörningar som inte producerade någon output.

## process-verktyg

Åtgärder:

* `list`: körande + avslutade sessioner
* `poll`: töm ny utdata för en session (rapporterar även avslutsstatus)
* `log`: läs den aggregerade utdatan (stöder `offset` + `limit`)
* `write`: skicka stdin (`data`, valfri `eof`)
* `kill`: terminera en bakgrundssession
* `clear`: ta bort en avslutad session från minnet
* `remove`: döda om den körs, annars rensa om den är avslutad

Noteringar:

* Endast bakgrundssessioner listas/persisteras i minnet.
* Sessioner går förlorade vid omstart av processen (ingen persistens på disk).
* Sessionsloggar sparas endast i chatthistoriken om du kör `process poll/log` och verktygsresultatet registreras.
* `process` är avgränsad per agent; den ser endast sessioner som startats av den agenten.
* `process list` inkluderar en härledd `name` (kommandoverb + mål) för snabba överblickar.
* `process log` använder radbaserad `offset`/`limit` (utelämna `offset` för att hämta de senaste N raderna).
* När både `offset` och `limit` utelämnas returneras de senaste 200 raderna och en pagineringshint inkluderas.
* När `offset` anges och `limit` utelämnas returneras allt från `offset` till slutet (begränsas inte till 200).

## Exempel

Kör en lång uppgift och polla senare:

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{ "tool": "exec", "command": "sleep 5 && echo done", "yieldMs": 1000 }
```

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{ "tool": "process", "action": "poll", "sessionId": "<id>" }
```

Starta omedelbart i bakgrunden:

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{ "tool": "exec", "command": "npm run build", "background": true }
```

Skicka stdin:

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{ "tool": "process", "action": "write", "sessionId": "<id>", "data": "y\n" }
```