Мета

Мета — це одна стійка ціль, прив’язана до поточної сесії OpenClaw. Вона дає агенту й оператору спільний орієнтир для тривалої роботи, не перетворюючи цей орієнтир на фонове завдання, нагадування, завдання Cron або постійну вказівку.

Мети є станом сесії. Вони переміщуються разом із ключем сесії, переживають перезапуски процесу, відображаються в /goal, доступні моделі через інструменти мети й з’являються в нижньому колонтитулі TUI, коли активна сесія має мету.

Швидкий старт

Задати мету:

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

Перевірити її:

/goal

Призупинити її, коли робота навмисно очікує:

/goal pause waiting for CI

Відновити її:

/goal resume

Позначити як виконану:

/goal complete pushed and verified

Очистити її:

/goal clear

Для чого потрібні мети

Використовуйте мету, коли сесія має конкретний результат, який має залишатися видимим протягом багатьох ходів:

• Завершення PR: виправити, перевірити, виконати autoreview, надіслати зміни й відкрити або оновити PR.
• Налагоджувальний прогін: відтворити помилку, визначити відповідальну поверхню, внести виправлення й довести, що воно працює.
• Прохід по документації: прочитати релевантну документацію, написати нову сторінку, додати перехресні посилання й перевірити складання документації.
• Завдання супроводу: оглянути поточний стан, внести обмежені зміни, запустити відповідні перевірки й повідомити, що змінилося.

Мета — це не черга завдань. Використовуйте TaskFlow, завдання, завдання Cron або постійні вказівки, коли робота має виконуватися від’єднано, повторюватися за розкладом, розгалужуватися на керовану підроботу або зберігатися як політика.

Довідник команд

/goal без аргументів виводить поточний підсумок мети:

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

Команди:

• /goal або /goal status показує поточну мету.
• /goal start <objective> створює нову мету для поточної сесії.
• /goal set <objective> і /goal create <objective> є псевдонімами для start.
• /goal pause [note] призупиняє активну мету.
• /goal resume [note] відновлює призупинену, заблоковану, обмежену використанням або обмежену бюджетом мету.
• /goal complete [note] позначає мету як досягнуту.
• /goal done [note] є псевдонімом для complete.
• /goal block [note] позначає мету як заблоковану.
• /goal blocked [note] є псевдонімом для block.
• /goal clear видаляє мету із сесії.

У сесії одночасно може існувати лише одна мета. Запуск другої мети завершиться помилкою, доки поточну не буде очищено.

Статуси

Мети використовують невеликий набір статусів:

• active: сесія працює над досягненням мети.
• paused: оператор призупинив мету; /goal resume знову робить її активною.
• blocked: агент або оператор повідомив про справжній блокер; /goal resume знову робить її активною, коли доступна нова інформація або стан.
• budget_limited: налаштований бюджет токенів досягнуто; /goal resume перезапускає роботу з тієї самої мети.
• usage_limited: зарезервовано для станів зупинки через ліміти використання; /goal resume перезапускає роботу, коли це дозволено.
• complete: мету досягнуто. Виконані мети є кінцевими; використайте /goal clear перед запуском іншої мети.

/new і /reset очищають мету поточної сесії, бо вони навмисно починають свіжий контекст сесії.

Бюджети токенів

Мети можуть мати необов’язковий додатний бюджет токенів. Бюджет зберігається разом із метою й вимірюється від свіжого лічильника токенів сесії на момент створення. Якщо поточна сесія має лише застарілі або невідомі дані використання токенів на момент запуску мети, OpenClaw чекає наступного свіжого знімка токенів сесії й використовує його як базову точку, тому токени, витрачені до появи мети, не зараховуються до мети.

Коли використання токенів досягає бюджету, мета змінюється на budget_limited. Це не видаляє мету й не стирає ціль. Це повідомляє оператору й агенту, що мета більше не виконується активно, доки її не буде відновлено або очищено.

Бюджети токенів — це запобіжник мети сесії, а не ліміт виставлення рахунків. Квоти провайдера, звітування про витрати й поведінка контекстного вікна все одно використовують звичайні елементи керування використанням і моделлю OpenClaw.

Інструменти моделі

OpenClaw надає оболонкам агентів три базові інструменти мети:

• get_goal: прочитати поточну мету сесії, зокрема статус, ціль, використання токенів і бюджет токенів.
• create_goal: створити мету лише тоді, коли інструкції користувача, системи або розробника явно цього вимагають. Завершується помилкою, якщо сесія вже має мету.
• update_goal: позначити мету як complete або blocked.

Модель не може непомітно призупинити, відновити, очистити або замінити мету. Це елементи керування оператора/сесії через /goal і команди скидання. Це не дає агенту тихо зміщувати ціль, водночас зберігаючи чистий шлях для агента, щоб повідомити про досягнення або справжній блокер.

Інструмент update_goal має позначати мету як complete лише тоді, коли цілі дійсно досягнуто. Він має позначати мету як blocked лише тоді, коли та сама блокувальна умова повторилася й агент не може суттєво просунутися без нового введення користувача або зміни зовнішнього стану.

TUI

TUI тримає мету активної сесії видимою в нижньому колонтитулі поруч із агентом, сесією, моделлю, елементами керування запуском і лічильниками токенів.

Приклади нижнього колонтитула:

• Pursuing goal (12k/50k) для активної мети з бюджетом токенів.
• Goal paused (/goal resume) для призупиненої мети.
• Goal blocked (/goal resume) для заблокованої мети.
• Goal hit usage limits (/goal resume) для мети, обмеженої використанням.
• Goal unmet (50k/50k) для мети, обмеженої бюджетом.
• Goal achieved (42k) для виконаної мети.

Нижній колонтитул навмисно компактний. Використовуйте /goal для повної цілі, нотатки, бюджету токенів і доступних команд.

Поведінка каналів

Команда /goal працює в сесіях OpenClaw із підтримкою команд, зокрема в TUI та чат-поверхнях, які дозволяють текстові команди. Стан мети прив’язаний до ключа сесії, а не до транспорту. Якщо дві поверхні використовують ту саму сесію, вони бачать ту саму мету.

Стан мети не є директивою доставки. Він не примушує відповіді через канал, не змінює поведінку черги, не схвалює інструменти й не планує роботу.

Усунення несправностей

Goal error: goal already exists означає, що сесія вже має мету. Використайте /goal, щоб оглянути її, /goal complete, якщо її виконано, або /goal clear перед запуском іншої цілі.

Goal error: goal not found означає, що сесія ще не має мети. Запустіть її за допомогою /goal start <objective>.

Goal error: goal is already complete означає, що мета є кінцевою. Очистьте її перед запуском або відновленням іншої цілі.

Якщо використання токенів виглядає як 0 або застаріле, активна сесія може ще не мати свіжого знімка токенів. Використання оновлюється, коли OpenClaw записує використання сесії та підсумки, виведені з транскрипту.

Пов’язане

• Slash-команди
• TUI
• Інструмент сесії
• Compaction
• TaskFlow
• Постійні вказівки