Ziel

Ein Ziel ist eine dauerhafte Zielsetzung, die der aktuellen OpenClaw-Sitzung zugeordnet ist. Es gibt dem Agenten und dem Operator ein gemeinsames Ziel für länger laufende Arbeiten, ohne dieses Ziel in eine Hintergrundaufgabe, Erinnerung, einen Cron-Job oder Dauerauftrag umzuwandeln.

Ziele sind Sitzungsstatus: Sie werden mit dem Sitzungsschlüssel übertragen, bleiben über Prozessneustarts hinweg erhalten und erscheinen in /goal, den modellseitigen Ziel-Tools und in der Fußzeile der TUI.

Abgeschlossene entkoppelte Befehle kehren zum ursprünglichen benutzerseitigen Thread zurück, sodass der nächste Turn weiterhin dasselbe Ziel sieht, selbst wenn für die Befehlsausführung eine separate Sitzung mit eigenen Sandbox-Richtlinien verwendet wurde.

Schnellstart

/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 ist optional: /goal get CI green for PR 87469 erstellt ebenfalls ein Ziel, da jeder Text nach /goal, der kein bekanntes Aktionswort ist, als neue Zielsetzung behandelt wird.

Wofür Ziele vorgesehen sind

Verwenden Sie ein Ziel, wenn eine Sitzung ein konkretes Ergebnis hat, das über viele Turns hinweg sichtbar bleiben soll:

• Abschluss eines PRs: korrigieren, verifizieren, automatisch prüfen, pushen und den PR öffnen oder aktualisieren.
• Ein Debugging-Durchlauf: den Fehler reproduzieren, die zuständige Oberfläche identifizieren, korrigieren und die Korrektur nachweisen.
• Eine Dokumentationsüberarbeitung: die relevanten Dokumente lesen, die neue Seite verfassen, Querverweise hinzufügen und den Dokumentations-Build verifizieren.
• Eine Wartungsaufgabe: den aktuellen Zustand prüfen, begrenzte Änderungen vornehmen, die richtigen Prüfungen ausführen und die Änderungen melden.

Ein Ziel ist keine Aufgabenwarteschlange. Verwenden Sie Task Flow, Aufgaben, Cron-Jobs oder Daueraufträge, wenn Arbeiten entkoppelt ausgeführt, nach einem Zeitplan wiederholt, in verwaltete Teilaufgaben aufgegliedert oder als Richtlinie beibehalten werden sollen.

Befehlsreferenz

/goal ohne Argumente gibt die aktuelle Zielzusammenfassung aus:

ZielStatus: aktivZielsetzung: CI für PR 87469 erfolgreich abschließen und die Korrektur pushenVerwendete Token: 12kToken-Budget: 12k/50k Befehle: /goal edit <objective>, /goal pause, /goal complete, /goal clear

In einer Sitzung kann jeweils nur ein Ziel vorhanden sein. Das Starten eines zweiten Ziels schlägt mit Goal error: goal already exists fehl, bis das aktuelle Ziel gelöscht wurde.

/goal start akzeptiert kein Token-Budget-Flag; ein Budget kann nur über das modellseitige Tool create_goal festgelegt werden.

Status

• active: Die Sitzung verfolgt das Ziel.
• paused: Der Operator hat das Ziel pausiert; /goal resume aktiviert es wieder.
• blocked: Der Agent oder Operator hat einen tatsächlichen Blocker gemeldet; /goal resume aktiviert es wieder, sobald neue Informationen oder ein neuer Zustand verfügbar sind.
• budget_limited: Das konfigurierte Token-Budget wurde erreicht; /goal resume setzt die Verfolgung derselben Zielsetzung mit einem neuen Budgetfenster fort.
• usage_limited: Für einen zukünftigen Stoppzustand aufgrund eines Nutzungslimits reserviert; /goal resume setzt die Verfolgung auf dieselbe Weise fort.
• complete: Das Ziel wurde erreicht. Abgeschlossene Ziele sind endgültig; verwenden Sie /goal clear, bevor Sie ein weiteres Ziel starten.

/new und /reset löschen das aktuelle Sitzungsziel, da sie absichtlich einen neuen Sitzungskontext beginnen.

Token-Budgets

Ziele können ein optionales positives Token-Budget haben, das über den Parameter token_budget des Tools create_goal festgelegt wird. Das Budget wird ab dem aktuellen Token-Zählerstand der Sitzung zum Zeitpunkt der Zielerstellung gemessen. Wenn die Sitzung beim Start des Ziels nur über einen veralteten oder unbekannten Token-Snapshot verfügt, wartet OpenClaw auf den nächsten aktuellen Snapshot und verwendet diesen als Ausgangswert, sodass Token, die vor der Existenz des Ziels verbraucht wurden, diesem nicht angerechnet werden.

Wenn die Nutzung das Budget erreicht, wechselt das Ziel zu budget_limited. Dadurch wird das Ziel weder gelöscht noch die Zielsetzung entfernt; der Operator und der Agent werden darüber informiert, dass das Ziel nicht mehr aktiv verfolgt wird, bis es fortgesetzt oder gelöscht wird. Beim Fortsetzen beginnt ein neues Budgetfenster beim aktuellen Token-Zählerstand.

Token-Budgets dienen als Leitplanke für Sitzungsziele, nicht als Abrechnungslimit. Provider- Kontingente, Kostenberichte und das Verhalten des Kontextfensters verwenden weiterhin die normalen Nutzungs- und Modellsteuerungen von OpenClaw.

Modell-Tools

OpenClaw stellt Agent-Harnesses drei Ziel-Tools bereit:

Das Modell kann ein Ziel nicht unbemerkt pausieren, fortsetzen, löschen oder ersetzen. Dies bleiben Operator- und Sitzungssteuerungen über /goal und Zurücksetzungsbefehle, sodass der Agent das Erreichen des Ziels oder einen tatsächlichen Blocker melden kann, ohne das Ziel unbemerkt zu verschieben.

update_goal sollte ein Ziel nur dann als complete markieren, wenn die Zielsetzung tatsächlich erreicht wurde. Ein Ziel sollte erst dann als blocked markiert werden, wenn dieselbe blockierende Bedingung in mindestens drei aufeinanderfolgenden Ziel-Turns erneut auftritt, nicht bei gewöhnlichen Schwierigkeiten oder fehlendem Feinschliff.

Zielkontext bei jedem Turn

Jeder Benutzer-/Chat-Turn mit einem aktiven Ziel enthält diese Kontextzeile mit der Benutzerrolle:

Aktives Ziel: <objective> — bringen Sie es voran oder aktualisieren Sie seinen Status (get_goal/update_goal).

OpenClaw hält die Zeile kompakt, indem lange Zielsetzungen gekürzt werden. Pausierte, blockierte, budgetbegrenzte, nutzungsbegrenzte und abgeschlossene Ziele werden nicht eingefügt, sodass ein Stopp durch den Operator wirksam bleibt, bis das Ziel fortgesetzt wird.

Control UI

Die webbasierte Control UI zeigt das Ziel als kompakte Plakette über dem Chat-Eingabefeld: ein Statussymbol, die Statusbezeichnung (zum Beispiel Pursuing goal), die gekürzte Zielsetzung und einen live aktualisierten Zeitgeber für die verstrichene Zeit.

Die Plakette enthält Inline-Steuerelemente:

• Stift füllt das Eingabefeld mit /goal edit <objective>, sodass die Zielsetzung neu formuliert und abgesendet werden kann.
• Pausieren/Fortsetzen wechselt abhängig vom aktuellen Status zwischen /goal pause und /goal resume.
• Papierkorb sendet /goal clear.
• Chevron erweitert die Plakette, um die vollständige Zielsetzung, den neuesten Statushinweis, die Token-Nutzung und die verstrichene Zeit anzuzeigen.

Die Aktionsschaltflächen sind ausgeblendet, solange das Eingabefeld nicht senden kann (zum Beispiel wenn die Gateway-Verbindung unterbrochen ist); das Chevron zum Erweitern funktioniert weiterhin.

TUI

Die Fußzeile der TUI hält das Ziel der aktiven Sitzung neben den Feldern für Agent, Sitzung und Modell sowie vor den Token-/Modusindikatoren sichtbar.

Beispiele für die Fußzeile:

• Pursuing goal (12k/50k) für ein aktives Ziel mit Token-Budget.
• Goal paused (/goal resume) für ein pausiertes Ziel.
• Goal blocked (/goal resume) für ein blockiertes Ziel.
• Goal hit usage limits (/goal resume) für ein nutzungsbegrenztes Ziel.
• Goal unmet (50k/50k) für ein budgetbegrenztes Ziel.
• Goal achieved (42k) für ein abgeschlossenes Ziel.

Die Fußzeile ist absichtlich kompakt. Verwenden Sie /goal für die vollständige Zielsetzung, den Hinweis, das Token-Budget und die verfügbaren Befehle.

Kanalverhalten

/goal funktioniert in befehlsfähigen OpenClaw-Sitzungen, einschließlich der TUI und Chat-Oberflächen, die Textbefehle erlauben. Der Zielstatus ist dem Sitzungsschlüssel zugeordnet, nicht dem Transport, sodass zwei Oberflächen mit demselben Sitzungsschlüssel dasselbe Ziel sehen.

Der Zielstatus ist keine Zustellanweisung: Er erzwingt keine Antworten über einen Kanal, ändert nicht das Warteschlangenverhalten, genehmigt keine Tools und plant keine Arbeiten.

Fehlerbehebung

Wenn die Token-Nutzung 0 anzeigt oder veraltet erscheint, verfügt die aktive Sitzung möglicherweise noch nicht über einen aktuellen Token-Snapshot. Die Nutzung wird aktualisiert, während OpenClaw die Sitzungsnutzung und aus dem Transkript abgeleitete Gesamtwerte erfasst.

Verwandte Themen

• Slash-Befehle
• TUI
• Sitzungs-Tool
• Compaction
• Task Flow
• Daueraufträge