Doel

Een doel is één duurzame doelstelling die aan de huidige OpenClaw-sessie is gekoppeld. Het geeft de agent en de operator een gezamenlijk richtpunt voor langdurige werkzaamheden, zonder dat richtpunt om te zetten in een achtergrondtaak, herinnering, Cron-taak of vaste opdracht.

Doelen zijn sessiestatus: ze bewegen mee met de sessiesleutel, blijven behouden na het herstarten van processen en verschijnen in /goal, de doeltools voor het model en de voettekst van de TUI.

Snel aan de slag

/goal start get CI green for PR 87469 and push the fix/goal/goal edit get CI green for PR 87469, push the fix, and update docs/goal pause waiting for CI/goal resume/goal complete pushed and verified/goal clear

start is optioneel: /goal get CI green for PR 87469 maakt ook een doel aan, omdat alle tekst na /goal die geen bekend actiewoord is, als een nieuwe doelstelling wordt behandeld.

Waarvoor doelen dienen

Gebruik een doel wanneer een sessie een concreet resultaat heeft dat gedurende vele beurten zichtbaar moet blijven:

• Een PR afronden: corrigeren, verifiëren, automatisch beoordelen, pushen en de PR openen of bijwerken.
• Een foutopsporingsronde: de fout reproduceren, het verantwoordelijke onderdeel identificeren, corrigeren en de oplossing aantonen.
• Een documentatieronde: de relevante documentatie lezen, de nieuwe pagina schrijven, kruisverwijzingen toevoegen en de documentatiebuild verifiëren.
• Een onderhoudstaak: de huidige status inspecteren, afgebakende wijzigingen aanbrengen, de juiste controles uitvoeren en rapporteren wat er is gewijzigd.

Een doel is geen takenwachtrij. Gebruik TaskFlow, taken, Cron-taken of vaste opdrachten wanneer werkzaamheden losgekoppeld moeten worden uitgevoerd, volgens een planning moeten worden herhaald, moeten worden opgesplitst in beheerde subtaken of als beleid moeten blijven gelden.

Opdrachtenoverzicht

/goal zonder argumenten toont de samenvatting van het huidige doel:

DoelStatus: actiefDoelstelling: CI voor PR 87469 succesvol maken en de correctie pushenGebruikte tokens: 12kTokenbudget: 12k/50k Opdrachten: /goal edit <doelstelling>, /goal pause, /goal complete, /goal clear

Er kan slechts één doel tegelijk in een sessie bestaan. Het starten van een tweede doel mislukt met Goal error: goal already exists totdat het huidige doel is gewist.

/goal start accepteert geen vlag voor het tokenbudget; een budget kan alleen worden ingesteld via de modeltool create_goal.

Statussen

• active: de sessie streeft het doel na.
• paused: de operator heeft het doel gepauzeerd; /goal resume maakt het weer actief.
• blocked: de agent of operator heeft een echte blokkade gemeld; /goal resume maakt het weer actief wanneer nieuwe informatie of een nieuwe status beschikbaar is.
• budget_limited: het geconfigureerde tokenbudget is bereikt; /goal resume hervat het nastreven van dezelfde doelstelling met een nieuw budgetvenster.
• usage_limited: gereserveerd voor een toekomstige stopstatus wegens een gebruikslimiet; /goal resume hervat het nastreven van het doel op dezelfde manier.
• complete: het doel is bereikt. Voltooide doelen zijn definitief; gebruik /goal clear voordat u een ander doel start.

/new en /reset wissen het huidige sessiedoel, omdat ze bewust met een nieuwe sessiecontext beginnen.

Tokenbudgetten

Doelen kunnen een optioneel positief tokenbudget hebben, ingesteld via de parameter token_budget van de tool create_goal. Het budget wordt gemeten vanaf het actuele aantal tokens van de sessie op het moment dat het doel wordt aangemaakt. Als de sessie bij aanvang van het doel alleen een verouderde of onbekende tokenmomentopname heeft, wacht OpenClaw op de volgende actuele momentopname en gebruikt die als uitgangspunt, zodat tokens die zijn verbruikt voordat het doel bestond niet eraan worden toegerekend.

Wanneer het gebruik het budget bereikt, krijgt het doel de status budget_limited. Hierdoor wordt het doel niet verwijderd en de doelstelling niet gewist; het geeft de operator en de agent aan dat het doel niet langer actief wordt nagestreefd totdat het wordt hervat of gewist. Bij hervatten begint een nieuw budgetvenster vanaf het huidige actuele aantal tokens.

Tokenbudgetten zijn een vangrail voor sessiedoelen, geen factureringslimiet. Providerquota, kostenrapportage en gedrag van het contextvenster blijven de normale gebruiks- en modelinstellingen van OpenClaw volgen.

Modeltools

OpenClaw stelt drie doeltools beschikbaar aan agentharnassen:

Het model kan een doel niet stilzwijgend pauzeren, hervatten, wissen of vervangen. Dit blijven bedieningselementen voor de operator en sessie via /goal en resetopdrachten, zodat de agent kan melden dat het doel is bereikt of dat er een echte blokkade is zonder ongemerkt het richtpunt te verplaatsen.

update_goal mag een doel alleen als complete markeren wanneer de doelstelling daadwerkelijk is bereikt. Het mag een doel alleen als blocked markeren nadat dezelfde blokkerende omstandigheid gedurende ten minste drie opeenvolgende doelbeurten terugkeert, niet bij gewone moeilijkheden of ontbrekende afwerking.

Doelcontext bij elke beurt

Elke gebruikers-/chatbeurt met een actief doel bevat deze contextregel met gebruikersrol:

Actief doel: <doelstelling> — werk eraan verder of werk de status bij (get_goal/update_goal).

OpenClaw houdt de regel compact door lange doelstellingen af te kappen. Gepauzeerde, geblokkeerde, budgetbeperkte, gebruiksbeperkte en voltooide doelen worden niet ingevoegd, zodat een stop door de operator van kracht blijft totdat het doel wordt hervat.

Bedieningsinterface

De webgebaseerde bedieningsinterface toont het doel als een compacte capsule boven het invoerveld voor de chat: een statuspictogram, het statuslabel (bijvoorbeeld Doel wordt nagestreefd), de afgekorte doelstelling en een live timer voor de verstreken tijd.

De capsule bevat bedieningselementen:

• Potlood vult het invoerveld vooraf met /goal edit <objective>, zodat de doelstelling kan worden geherformuleerd en verzonden.
• Pauzeren / hervatten schakelt op basis van de huidige status tussen /goal pause en /goal resume.
• Prullenbak verzendt /goal clear.
• Chevron vouwt de capsule uit om de volledige doelstelling, de nieuwste statusnotitie, het tokengebruik en de verstreken tijd weer te geven.

De actieknoppen zijn verborgen zolang het invoerveld niet kan verzenden (bijvoorbeeld wanneer de verbinding met de Gateway is verbroken); de chevron voor uitvouwen blijft werken.

TUI

De voettekst van de TUI houdt het doel van de actieve sessie zichtbaar naast de velden voor de agent, sessie en het model, vóór de indicatoren voor tokens en modus.

Voorbeelden van voetteksten:

• Doel wordt nagestreefd (12k/50k) voor een actief doel met een tokenbudget.
• Doel gepauzeerd (/goal resume) voor een gepauzeerd doel.
• Doel geblokkeerd (/goal resume) voor een geblokkeerd doel.
• Doel heeft gebruikslimieten bereikt (/goal resume) voor een gebruiksbeperkt doel.
• Doel niet bereikt (50k/50k) voor een budgetbeperkt doel.
• Doel bereikt (42k) voor een voltooid doel.

De voettekst is bewust compact. Gebruik /goal voor de volledige doelstelling, notitie, het tokenbudget en de beschikbare opdrachten.

Kanaalgedrag

/goal werkt in OpenClaw-sessies die opdrachten ondersteunen, waaronder de TUI en chatinterfaces die tekstopdrachten toestaan. De doelstatus is gekoppeld aan de sessiesleutel, niet aan het transport, zodat twee interfaces die een sessiesleutel delen hetzelfde doel zien.

De doelstatus is geen afleveringsinstructie: deze dwingt geen antwoorden via een kanaal af, wijzigt het wachtrijgedrag niet, keurt geen tools goed en plant geen werkzaamheden.

Problemen oplossen

Als het tokengebruik 0 weergeeft of verouderd lijkt, heeft de actieve sessie mogelijk nog geen actuele tokenmomentopname. Het gebruik wordt vernieuwd wanneer OpenClaw sessiegebruik en uit het transcript afgeleide totalen registreert.

Gerelateerd

• Slash-opdrachten
• TUI
• Sessietool
• Compaction
• TaskFlow
• Vaste opdrachten