Hintergrundausführung und Prozesswerkzeug

OpenClaw führt Shell-Befehle über das exec-Tool aus und hält lang laufende Aufgaben im Arbeitsspeicher. Das process-Tool verwaltet diese Hintergrundsitzungen.

exec-Tool

Parameter:

Verhalten:

• Ausführungen im Vordergrund geben die Ausgabe direkt zurück.
• Bei Ausführung im Hintergrund (explizit oder durch eine yieldMs-Zeitüberschreitung) gibt das Tool status: "running" + sessionId und das kurze Ende der Ausgabe zurück.
• Hintergrundausführungen und Ausführungen mit yieldMs übernehmen tools.exec.timeoutSec, sofern beim Aufruf kein explizites timeout übergeben wird.
• Die Ausgabe verbleibt im Arbeitsspeicher, bis die Sitzung abgefragt oder gelöscht wird.
• Wenn das process-Tool nicht zugelassen ist, wird exec synchron ausgeführt und ignoriert yieldMs/background.
• Gestartete exec-Befehle erhalten OPENCLAW_SHELL=exec für kontextabhängige Shell-/Profilregeln.
• Für lang laufende Arbeiten, die jetzt beginnen: Starten Sie sie einmal und verlassen Sie sich, sofern aktiviert, auf die automatische Abschlussaktivierung, sobald der Befehl eine Ausgabe erzeugt oder fehlschlägt.
• Wenn die automatische Abschlussaktivierung nicht verfügbar ist oder Sie eine Bestätigung für einen erfolgreichen Abschluss ohne Ausgabe benötigen, fragen Sie den Status mit process ab.
• Bilden Sie Erinnerungen oder verzögerte Folgeaktionen nicht mit sleep-Schleifen oder wiederholten Abfragen nach – verwenden Sie Cron für zukünftige Arbeiten.

Umgebungsvariablen zum Überschreiben

Konfiguration (gegenüber Umgebungsvariablen zum Überschreiben bevorzugt)

Überbrückung von Kindprozessen

Wenn Sie lang laufende Kindprozesse außerhalb der exec-/process-Tools starten (CLI-Neustarts, Gateway-Hilfsprozesse), binden Sie den Hilfsmechanismus zur Überbrückung von Kindprozessen ein, damit Beendigungssignale weitergeleitet und Listener bei Beendigung oder Fehlern entfernt werden. Dadurch werden verwaiste Prozesse unter systemd vermieden und das Herunterfahren bleibt plattformübergreifend konsistent.

process-Tool

Aktionen:

Hinweise:

• Nur Hintergrundsitzungen werden aufgeführt/gespeichert – ausschließlich im Arbeitsspeicher, nicht auf der Festplatte. Sitzungen gehen bei einem Prozessneustart verloren.
• Eine aktive Hintergrundsitzung blockiert die kooperative Suspendierung des Hosts und einen sicheren Gateway-Neustart, bis der Prozesseigentümer das tatsächliche Ende bestätigt.
• process remove kann eine laufende Sitzung unmittelbar nach Anforderung ihrer Beendigung ausblenden; Suspendierung und Neustart bleiben bis zur Bestätigung des Endes blockiert.
• Sitzungsprotokolle werden nur im Chatverlauf gespeichert, wenn Sie process poll/log ausführen und das Tool-Ergebnis aufgezeichnet wird.
• process ist auf den jeweiligen Agenten beschränkt; es sieht nur Sitzungen, die von diesem Agenten gestartet wurden.
• Verwenden Sie poll/log für Status, Protokolle oder Abschlussbestätigungen, wenn die automatische Abschlussaktivierung nicht verfügbar ist.
• Verwenden Sie log, bevor Sie eine interaktive CLI wiederherstellen, damit das aktuelle Transkript, der stdin-Status und der Hinweis zum Warten auf Eingaben gemeinsam sichtbar sind.
• Verwenden Sie write/send-keys/submit/paste/kill, wenn eine Eingabe oder ein Eingriff erforderlich ist.
• process list enthält für eine schnelle Übersicht einen abgeleiteten name (Befehlsverb + Ziel).
• process list, poll und log melden waitingForInput nur, wenn die Sitzung weiterhin über beschreibbares stdin verfügt und länger als die Eingabewarteschwelle inaktiv war (Standardwert 15000 ms, OPENCLAW_PROCESS_INPUT_WAIT_IDLE_MS).
• process log verwendet zeilenbasierte Werte für offset/limit. Wenn beide weggelassen werden, gibt es die letzten 200 Zeilen mit einem Hinweis zur Seitennavigation zurück. Wenn offset festgelegt ist und limit nicht, erfolgt die Rückgabe ab offset bis zum Ende (nicht auf 200 begrenzt).
• timeout von poll wartet vor der Rückgabe bis zur angegebenen Anzahl von Millisekunden; Werte über 30000 werden auf 30000 begrenzt.
• Abfragen dienen dem bedarfsgesteuerten Status, nicht der Planung von Warteschleifen. Wenn die Arbeit später erfolgen soll, verwenden Sie Cron.

Beispiele

Eine lang laufende Aufgabe ausführen und später abfragen:

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

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

Eine interaktive Sitzung vor dem Senden einer Eingabe prüfen:

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

Sofort im Hintergrund starten:

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

stdin senden:

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

PTY-Tasten senden:

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

Aktuelle Zeile absenden:

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

Wörtlichen Text einfügen:

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

Verwandte Themen

• Exec-Tool
• Exec-Genehmigungen