Cel

Cel to jeden trwały zamiar przypisany do bieżącej sesji OpenClaw. Zapewnia agentowi i operatorowi wspólny punkt docelowy dla długotrwałej pracy, bez przekształcania go w zadanie działające w tle, przypomnienie, zadanie Cron ani stałe zlecenie.

Cele są stanem sesji: są powiązane z kluczem sesji, zachowują się po ponownym uruchomieniu procesu i pojawiają się w /goal, narzędziach celów dostępnych dla modelu oraz w stopce TUI.

Szybki start

/goal start doprowadź CI do stanu poprawnego dla PR 87469 i wypchnij poprawkę/goal/goal edit doprowadź CI do stanu poprawnego dla PR 87469, wypchnij poprawkę i zaktualizuj dokumentację/goal pause oczekiwanie na CI/goal resume/goal complete wypchnięto i zweryfikowano/goal clear

start jest opcjonalne: /goal doprowadź CI do stanu poprawnego dla PR 87469 również tworzy cel, ponieważ każdy tekst po /goal, który nie jest rozpoznanym słowem akcji, jest traktowany jako nowy zamiar.

Do czego służą cele

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

• Finalizacja PR: poprawienie, zweryfikowanie, automatyczny przegląd, wypchnięcie oraz otwarcie lub zaktualizowanie PR.
• Sesja debugowania: odtworzenie błędu, zidentyfikowanie odpowiedzialnego obszaru, wprowadzenie poprawki i potwierdzenie jej działania.
• Prace nad dokumentacją: przeczytanie odpowiedniej dokumentacji, napisanie nowej strony, dodanie odsyłaczy i zweryfikowanie kompilacji dokumentacji.
• Zadanie konserwacyjne: sprawdzenie bieżącego stanu, wprowadzenie ograniczonych zmian, uruchomienie odpowiednich kontroli i opisanie zmian.

Cel nie jest kolejką zadań. Użyj Task Flow, zadań, zadań Cron lub stałych zleceń, gdy praca ma działać niezależnie, powtarzać się zgodnie z harmonogramem, rozdzielać się na zarządzane podzadania lub być utrwalona jako zasada.

Dokumentacja poleceń

/goal bez argumentów wyświetla podsumowanie bieżącego celu:

CelStan: aktywnyZamiar: doprowadź CI do stanu poprawnego dla PR 87469 i wypchnij poprawkęUżyte tokeny: 12kBudżet tokenów: 12k/50k Polecenia: /goal edit <zamiar>, /goal pause, /goal complete, /goal clear

W danej sesji może istnieć tylko jeden cel naraz. Próba rozpoczęcia drugiego celu kończy się błędem Goal error: goal already exists, dopóki bieżący cel nie zostanie usunięty.

/goal start nie przyjmuje flagi budżetu tokenów; budżet można ustawić wyłącznie za pomocą dostępnego dla modelu narzędzia create_goal.

Stany

• active: sesja dąży do osiągnięcia celu.
• paused: operator wstrzymał cel; /goal resume ponownie go aktywuje.
• blocked: agent lub operator zgłosił rzeczywistą przeszkodę; /goal resume ponownie aktywuje cel, gdy pojawią się nowe informacje lub zmieni się stan.
• budget_limited: skonfigurowany budżet tokenów został wyczerpany; /goal resume wznawia dążenie do tego samego zamiaru z nowym oknem budżetu.
• usage_limited: stan zarezerwowany na potrzeby przyszłego zatrzymania z powodu limitu użycia; /goal resume wznawia dążenie w ten sam sposób.
• complete: cel został osiągnięty. Ukończone cele są stanem końcowym; przed rozpoczęciem kolejnego celu użyj /goal clear.

/new i /reset usuwają bieżący cel sesji, ponieważ celowo rozpoczynają nowy kontekst sesji.

Budżety tokenów

Cele mogą mieć opcjonalny dodatni budżet tokenów, ustawiany za pomocą parametru token_budget narzędzia create_goal. Budżet jest mierzony od aktualnej liczby tokenów sesji w chwili utworzenia celu. Jeśli podczas rozpoczynania celu sesja ma jedynie nieaktualny lub nieznany stan tokenów, OpenClaw czeka na kolejny aktualny stan i używa go jako wartości bazowej, dzięki czemu tokeny wykorzystane przed utworzeniem celu nie są do niego zaliczane.

Gdy użycie osiągnie budżet, cel przechodzi do stanu budget_limited. Nie usuwa to celu ani zamiaru; informuje operatora i agenta, że cel nie jest już aktywnie realizowany, dopóki nie zostanie wznowiony lub usunięty. Wznowienie rozpoczyna nowe okno budżetu od bieżącej aktualnej liczby tokenów.

Budżety tokenów są zabezpieczeniem celu sesji, a nie limitem rozliczeniowym. Limity dostawcy, raportowanie kosztów i działanie okna kontekstu nadal korzystają ze standardowych mechanizmów użycia i sterowania modelem w OpenClaw.

Narzędzia modelu

OpenClaw udostępnia środowiskom agentów trzy narzędzia celów:

Model nie może niejawnie wstrzymać, wznowić, usunąć ani zastąpić celu. Operacje te pozostają mechanizmami sterowania operatora i sesji dostępnymi przez /goal oraz polecenia resetowania, dzięki czemu agent może zgłosić osiągnięcie celu lub rzeczywistą przeszkodę bez potajemnej zmiany zamiaru.

update_goal powinno oznaczyć cel jako complete tylko wtedy, gdy zamiar został rzeczywiście osiągnięty. Powinno oznaczyć cel jako blocked dopiero wtedy, gdy ta sama przeszkoda wystąpi w co najmniej trzech kolejnych turach celu, a nie z powodu zwykłych trudności lub braku ostatecznych poprawek.

Kontekst celu w każdej turze

Każda tura użytkownika lub czatu z aktywnym celem zawiera następujący wiersz kontekstu w roli użytkownika:

Aktywny cel: <zamiar> — realizuj go lub zaktualizuj jego stan (get_goal/update_goal).

OpenClaw zachowuje zwięzłość wiersza, skracając długie zamiary. Cele wstrzymane, zablokowane, ograniczone budżetem lub użyciem oraz ukończone nie są wstawiane, dzięki czemu zatrzymanie przez operatora obowiązuje do czasu wznowienia celu.

Interfejs sterowania

Internetowy interfejs sterowania wyświetla cel jako zwartą etykietę nad polem tworzenia wiadomości czatu: ikonę stanu, etykietę stanu (na przykład Realizowanie celu), skrócony zamiar oraz aktualizowany na żywo licznik czasu.

Etykieta zawiera wbudowane elementy sterujące:

• Ołówek wstępnie wypełnia pole tworzenia wiadomości tekstem /goal edit <objective>, aby można było przeformułować i przesłać zamiar.
• Wstrzymaj / wznów przełącza między /goal pause i /goal resume zależnie od bieżącego stanu.
• Kosz wysyła /goal clear.
• Szewron rozwija etykietę, aby wyświetlić pełny zamiar, najnowszą notatkę o stanie, użycie tokenów i czas, który upłynął.

Przyciski akcji są ukryte, gdy pole tworzenia wiadomości nie może wysyłać (na przykład gdy połączenie z Gateway jest niedostępne); szewron rozwijania nadal działa.

TUI

Stopka TUI wyświetla cel aktywnej sesji obok pól agenta, sesji i modelu, przed wskaźnikami tokenów i trybu.

Przykłady stopek:

• Realizowanie celu (12k/50k) dla aktywnego celu z budżetem tokenów.
• Cel wstrzymany (/goal resume) dla wstrzymanego celu.
• Cel zablokowany (/goal resume) dla zablokowanego celu.
• Cel osiągnął limity użycia (/goal resume) dla celu ograniczonego użyciem.
• Cel niezrealizowany (50k/50k) dla celu ograniczonego budżetem.
• Cel osiągnięty (42k) dla ukończonego celu.

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

Działanie w kanałach

/goal działa w sesjach OpenClaw obsługujących polecenia, w tym w TUI oraz interfejsach czatu, które zezwalają na polecenia tekstowe. Stan celu jest przypisany do klucza sesji, a nie do mechanizmu transportowego, dlatego dwa interfejsy współdzielące klucz sesji widzą ten sam cel.

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

Rozwiązywanie problemów

Jeśli użycie tokenów wynosi 0 lub wygląda na nieaktualne, aktywna sesja może jeszcze nie mieć aktualnego stanu tokenów. Użycie jest odświeżane, gdy OpenClaw rejestruje użycie sesji i sumy wyprowadzone z transkrypcji.

Powiązane

• Polecenia z ukośnikiem
• TUI
• Narzędzie sesji
• Compaction
• Task Flow
• Stałe zlecenia