Hoppa till huvudinnehåll

​
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: 
{ "tool": "exec", "command": "sleep 5 && echo done", "yieldMs": 1000 }

{ "tool": "process", "action": "poll", "sessionId": "<id>" }
Starta omedelbart i bakgrunden: 
{ "tool": "exec", "command": "npm run build", "background": true }
Skicka stdin: 
{ "tool": "process", "action": "write", "sessionId": "<id>", "data": "y\n" }