// dokumentacja openclaw

Sub-agenty w OpenClaw — uruchamianie agentow w tle

Wprowadzenie

Sub-agenty to uruchomienia agentow w tle, spawnowane z istniejacej sesji agenta. Dzialaja w izolowanych sesjach i raportuja wyniki z powrotem do kanalu wywolujacego po zakonczeniu pracy.

Komendy

Komenda slash /subagents umozliwia inspekcje i kontrole:

  • Listowanie, zabijanie, logowanie i monitorowanie aktywnych sub-agentow
  • Spawnowanie nowych agentow w tle za pomoca sessions_spawn
  • Kontrola wiazania watkow dla trwalego routingu sesji

Zachowanie spawnu

Spawnowanie jest nieblokujace i natychmiast zwraca identyfikator uruchomienia. Po zakonczeniu sub-agent oglasza wiadomosc z podsumowaniem/wynikiem z powrotem do kanalu czatowego wywolujacego. Dostarczanie odbywa sie za pomoca odpornego powiadomienia push, a nie pollingu.

Parametry konfiguracyjne

Narzedzie sessions_spawn akceptuje:

  • task (wymagany) — opis zadania do wykonania
  • model, thinking, runTimeoutSeconds — opcjonalne nadpisania
  • thread, mode, cleanup, sandbox — kontrolki sesji
  • label, agentId — identyfikacja i targetowanie

Polityka narzedzi

Domyslnie sub-agenty otrzymuja wszystkie narzedzia z wyjatkiem narzedzi sesji i narzedzi systemowych. Narzedzia zarzadzania sesjami sa ograniczone, chyba ze agent dziala jako orkiestrator glebokosci 1.

Zagniezdzone sub-agenty

Wlacz zagniezdanie przez maxSpawnDepth: 2, aby wspierac wzorce orkiestratora, gdzie sub-agenty koordynuja sub-sub-agentow pracownikow. Wyniki sa ogaszane w gore lancucha.

Wspolbieznosc i cleanup

Sub-agenty uzywaja dedykowanego pasa kolejki z konfigurowalnymi limitami. Automatyczna archiwizacja jest best-effort po archiveAfterMinutes (domyslnie 60 minut), zachowujac transkrypty przez zmiane nazwy.

Ograniczenia

  • Dostarczanie ogloszen jest best-effort — restarty gateway tracza oczekujace powiadomienia
  • Maksymalna glebokosc zagniezdzenia wynosi 5, zalecana jest glebokosc 2
  • Narzedzia sesji sa domyslnie niedostepne dla sub-agentow