Narzedzie exec w OpenClaw — wykonywanie polecen

Wprowadzenie

Narzedzie exec umozliwia wykonywanie polecen powloki w workspace'ach agenta. Obsluguje zarowno tryb pierwszoplanowy (foreground), jak i tlo (background), oferujac elastyczne konteksty wykonawcze z kontrolami bezpieczenstwa.

Glowna funkcjonalnosc

Uruchamiaj polecenia powloki w workspace. Obsluguje wykonywanie foreground oraz background przez process. Sesje tla sa ograniczone per agent, a wykonywanie w tle uruchamia sie automatycznie po konfigurowalnym opoznieniu.

Kluczowe parametry

• command (wymagany) — polecenie powloki do wykonania
• workdir — katalog roboczy (domyslnie biezacy)
• env — nadpisania zmiennych srodowiskowych
• yieldMs — opoznienie auto-background (domyslnie 10 000 ms)
• background — natychmiastowe wykonanie w tle
• timeout — przerwanie polecenia po czasie (domyslnie 1800 sekund)
• pty — uruchomienie w pseudoterminalu jesli dostepny
• host — lokalizacja wykonania: auto, sandbox, gateway lub node
• security — tryb wymuszania: deny, allowlist lub full
• elevated — zadanie podwyzszonych uprawnien do opuszczenia sandboxa

Hosty wykonawcze

Narzedzie inteligentnie kieruje polecenia do odpowiedniego hosta. Bez dodatkowej konfiguracji host=auto po prostu dziala: brak sandboxa oznacza rozwiazanie na gateway; aktywny sandbox oznacza pozostanie w sandboxie.

Funkcje bezpieczenstwa

• Bramy zatwierdzania (approval gates) dla wykonywania na gateway/node
• Wymuszanie allowlisty z bezpiecznymi plikami binarnymi dla filtrow stdin
• Ograniczenia ewaluacji inline interpreterow (jesli wlaczone)
• Odrzucanie nadpisywan zmiennych srodowiskowych PATH i loader przez hosta

Konfiguracja

Kluczowe ustawienia obejmuja:

• tools.exec.notifyOnExit — powiadomienie o zakonczeniu polecenia
• tools.exec.host — domyslny host wykonawczy
• tools.exec.security — poziom bezpieczenstwa
• tools.exec.safeBins — lista bezpiecznych plikow binarnych

Domyslnie wykonywanie na gateway i node nie wymaga zatwierdzenia (no-approval host exec).

Powiazane narzedzia

• Zarzadzanie procesami (polling, wysylanie klawiszy, operacje paste)
• Subnarzedzie apply_patch do edycji wielu plikow (modele OpenAI)
• Nadpisywanie sesji przez polecenie /exec