---
doc-schema-version: 1
read_when:
    - Ви хочете, щоб OpenClaw зберігав одну ціль видимою протягом тривалого сеансу
    - Потрібно призупинити, відновити, заблокувати, завершити або очистити ціль сеансу
    - Ви хочете зрозуміти інструменти get_goal, create_goal і update_goal
    - Ви хочете побачити, як цілі відображаються в TUI
summary: 'Цілі сеансу: довготривалі цілі для кожного сеансу, керування /goal, інструменти цілей моделі, бюджети токенів і стан TUI'
title: Мета
x-i18n:
    generated_at: "2026-06-27T18:25:56Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 4313983dff7f37496f6c996303cace75f6863a71c8a9cd5367fdafbcc3f459c4
    source_path: tools/goal.md
    workflow: 16
---

# Мета

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

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

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

Задати мету:

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

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

```text
/goal
```

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

```text
/goal pause waiting for CI
```

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

```text
/goal resume
```

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

```text
/goal complete pushed and verified
```

Очистити її:

```text
/goal clear
```

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

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

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

Мета — це не черга завдань. Використовуйте [TaskFlow](/uk/automation/taskflow),
[завдання](/uk/automation/tasks), [завдання Cron](/uk/automation/cron-jobs) або
[постійні вказівки](/uk/automation/standing-orders), коли робота має виконуватися від’єднано,
повторюватися за розкладом, розгалужуватися на керовану підроботу або зберігатися як політика.

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

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

```text
Goal
Status: active
Objective: get CI green for PR 87469 and push the fix
Tokens used: 12k
Token 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-команди](/uk/tools/slash-commands)
- [TUI](/uk/web/tui)
- [Інструмент сесії](/uk/concepts/session-tool)
- [Compaction](/uk/concepts/compaction)
- [TaskFlow](/uk/automation/taskflow)
- [Постійні вказівки](/uk/automation/standing-orders)