Cel

Cel to jeden trwały zamiar przypięty do bieżącej sesji OpenClaw. Daje agentowi i operatorowi wspólny punkt odniesienia dla długotrwałej pracy, bez przekształcania go w zadanie w tle, przypomnienie, zadanie cron ani stałe polecenie.

Cele są stanem sesji. Przenoszą się wraz z kluczem sesji, przetrwają ponowne uruchomienie procesu, pojawiają się w /goal, są dostępne dla modelu przez narzędzia celu i są widoczne w stopce TUI, gdy aktywna sesja ma cel.

Szybki start

Ustaw cel:

/goal start get CI green for PR 87469 and push the fix

Sprawdź go:

/goal

Wstrzymaj go, gdy praca celowo czeka:

/goal pause waiting for CI

Wznów go:

/goal resume

Oznacz jako ukończony:

/goal complete pushed and verified

Wyczyść go:

/goal clear

Do czego służą cele

Użyj celu, gdy sesja ma konkretny wynik, który powinien pozostać widoczny przez wiele tur:

• Domknięcie PR: napraw, zweryfikuj, uruchom autoreview, wypchnij oraz otwórz lub zaktualizuj PR.
• Przebieg debugowania: odtwórz błąd, wskaż odpowiedzialny obszar, popraw go i udowodnij naprawę.
• Przejście przez dokumentację: przeczytaj odpowiednią dokumentację, napisz nową stronę, dodaj linki krzyżowe i zweryfikuj kompilację dokumentacji.
• Zadanie utrzymaniowe: sprawdź bieżący stan, wprowadź ograniczone zmiany, uruchom właściwe kontrole i zgłoś, co się zmieniło.

Cel nie jest kolejką zadań. Użyj Przepływu zadań, zadań, zadań cron lub stałych poleceń, gdy praca ma działać odłączona, powtarzać się według harmonogramu, rozgałęziać się na zarządzane podprace albo utrzymywać się jako zasada.

Dokumentacja poleceń

/goal bez argumentów wypisuje podsumowanie bieżącego celu:

GoalStatus: activeObjective: get CI green for PR 87469 and push the fixTokens used: 12kToken budget: 12k/50k Commands: /goal pause, /goal complete, /goal clear

Polecenia:

• /goal lub /goal status pokazuje bieżący cel.
• /goal start <objective> tworzy nowy cel dla bieżącej sesji.
• /goal set <objective> i /goal create <objective> są aliasami start.
• /goal pause [note] wstrzymuje aktywny cel.
• /goal resume [note] wznawia cel wstrzymany, zablokowany, ograniczony użyciem albo ograniczony budżetem.
• /goal complete [note] oznacza cel jako osiągnięty.
• /goal done [note] jest aliasem complete.
• /goal block [note] oznacza cel jako zablokowany.
• /goal blocked [note] jest aliasem block.
• /goal clear usuwa cel z sesji.

W sesji może istnieć tylko jeden cel naraz. Rozpoczęcie drugiego celu kończy się niepowodzeniem, dopóki bieżący nie zostanie wyczyszczony.

Statusy

Cele używają małego zestawu statusów:

• active: sesja realizuje cel.
• paused: operator wstrzymał cel; /goal resume ponownie go aktywuje.
• blocked: agent lub operator zgłosił rzeczywistą blokadę; /goal resume ponownie go aktywuje, gdy będą dostępne nowe informacje lub nowy stan.
• budget_limited: skonfigurowany budżet tokenów został osiągnięty; /goal resume wznawia realizację tego samego zamiaru.
• usage_limited: zarezerwowane dla stanów zatrzymania z powodu limitów użycia; /goal resume wznawia realizację, gdy jest dozwolona.
• complete: cel został osiągnięty. Ukończone cele są terminalne; użyj /goal clear przed rozpoczęciem kolejnego celu.

/new i /reset czyszczą cel bieżącej sesji, ponieważ celowo rozpoczynają świeży kontekst sesji.

Budżety tokenów

Cele mogą mieć opcjonalny dodatni budżet tokenów. Budżet jest przechowywany z celem i mierzony od świeżej liczby tokenów sesji w chwili utworzenia. Jeśli bieżąca sesja ma tylko nieaktualne lub nieznane użycie tokenów, gdy cel startuje, OpenClaw czeka na następną świeżą migawkę tokenów sesji i używa jej jako punktu bazowego, więc tokeny wydane przed istnieniem celu nie są doliczane do celu.

Gdy użycie tokenów osiągnie budżet, cel zmienia się na budget_limited. To nie usuwa celu ani nie kasuje zamiaru. Informuje operatora i agenta, że cel nie jest już aktywnie realizowany, dopóki nie zostanie wznowiony lub wyczyszczony.

Budżety tokenów są zabezpieczeniem celu sesji, a nie limitem rozliczeniowym. Limity dostawcy, raportowanie kosztów i zachowanie okna kontekstu nadal używają normalnych kontroli użycia i modelu OpenClaw.

Narzędzia modelu

OpenClaw udostępnia harnessom agentów trzy podstawowe narzędzia celu:

• get_goal: odczytuje cel bieżącej sesji, w tym status, zamiar, użycie tokenów i budżet tokenów.
• create_goal: tworzy cel tylko wtedy, gdy instrukcje użytkownika, systemowe lub deweloperskie jawnie o to proszą. Kończy się niepowodzeniem, jeśli sesja ma już cel.
• update_goal: oznacza cel jako complete albo blocked.

Model nie może po cichu wstrzymać, wznowić, wyczyścić ani zastąpić celu. To są kontrole operatora/sesji przez /goal i polecenia resetowania. Dzięki temu agent nie przesuwa po cichu celu, zachowując czystą ścieżkę dla agenta do zgłoszenia osiągnięcia albo rzeczywistej blokady.

Narzędzie update_goal powinno oznaczyć cel jako complete tylko wtedy, gdy zamiar jest faktycznie osiągnięty. Powinno oznaczyć cel jako blocked tylko wtedy, gdy ten sam warunek blokujący się powtórzył, a agent nie może poczynić znaczącego postępu bez nowych danych od użytkownika albo zmiany stanu zewnętrznego.

TUI

TUI utrzymuje cel aktywnej sesji widoczny w stopce obok agenta, sesji, modelu, kontrolek uruchomienia i liczników tokenów.

Przykłady stopki:

• Pursuing goal (12k/50k) dla aktywnego celu z budżetem tokenów.
• Goal paused (/goal resume) dla wstrzymanego celu.
• Goal blocked (/goal resume) dla zablokowanego celu.
• Goal hit usage limits (/goal resume) dla celu ograniczonego użyciem.
• Goal unmet (50k/50k) dla celu ograniczonego budżetem.
• Goal achieved (42k) dla ukończonego celu.

Stopka jest celowo zwięzła. Użyj /goal, aby zobaczyć pełny zamiar, notatkę, budżet tokenów i dostępne polecenia.

Zachowanie kanałów

Polecenie /goal działa w sesjach OpenClaw obsługujących polecenia, w tym w TUI i powierzchniach czatu, które pozwalają na polecenia tekstowe. Stan celu jest przypięty do klucza sesji, a nie do transportu. Jeśli dwie powierzchnie używają tej samej sesji, widzą ten sam cel.

Stan celu nie jest dyrektywą dostarczania. Nie wymusza odpowiedzi przez kanał, nie zmienia zachowania kolejki, nie zatwierdza narzędzi ani nie planuje pracy.

Rozwiązywanie problemów

Goal error: goal already exists oznacza, że sesja ma już cel. Użyj /goal, aby go sprawdzić, /goal complete, jeśli jest wykonany, albo /goal clear przed rozpoczęciem innego zamiaru.

Goal error: goal not found oznacza, że sesja nie ma jeszcze celu. Rozpocznij go poleceniem /goal start <objective>.

Goal error: goal is already complete oznacza, że cel jest terminalny. Wyczyść go przed rozpoczęciem lub wznowieniem innego zamiaru.

Jeśli użycie tokenów wygląda jak 0 albo jest nieaktualne, aktywna sesja może jeszcze nie mieć świeżej migawki tokenów. Użycie odświeża się, gdy OpenClaw zapisuje użycie sesji i sumy pochodzące z transkrypcji.

Powiązane

• Polecenia ukośnikowe
• TUI
• Narzędzie sesji
• Compaction
• Przepływ zadań
• Stałe polecenia