> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# TUI

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

### Режим Gateway

1. Запустіть Gateway.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway
```

2. Відкрийте TUI.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw tui
```

3. Введіть повідомлення й натисніть Enter.

Віддалений Gateway:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw tui --url ws://<host>:<port> --token <gateway-token>
```

Використовуйте `--password`, якщо ваш Gateway використовує автентифікацію паролем.

### Локальний режим

Запустіть TUI без Gateway:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw chat
# or
openclaw tui --local
```

Примітки:

* `openclaw chat` і `openclaw terminal` є псевдонімами для `openclaw tui --local`.
* `--local` не можна поєднувати з `--url`, `--token` або `--password`.
* Локальний режим використовує вбудоване середовище виконання агента напряму. Більшість локальних інструментів працює, але функції лише для Gateway недоступні.
* Після того як файл конфігурації матиме авторські налаштування, `openclaw` і `openclaw crestodian` також використовують цю оболонку TUI, а Crestodian виступає локальним бекендом чату для налаштування й ремонту.

## Що ви бачите

* Заголовок: URL підключення, поточний агент, поточна сесія.
* Журнал чату: повідомлення користувача, відповіді асистента, системні сповіщення, картки інструментів.
* Рядок стану: стан підключення/запуску (підключення, виконання, потокове передавання, очікування, помилка).
* Нижній колонтитул: агент + сесія + модель + стан цілі + think/fast/verbose/trace/reasoning + кількість токенів + доставлення. Коли `tui.footer.showRemoteHost` увімкнено, віддалені підключення Gateway також показують хост підключення.
* Введення: текстовий редактор з автодоповненням.

## Ментальна модель: агенти + сесії

* Агенти — це унікальні слаги (наприклад, `main`, `research`). Gateway надає список.

* Сесії належать поточному агенту.

* Ключі сесій зберігаються як `agent:<agentId>:<sessionKey>`.
  * Якщо ви введете `/session main`, TUI розгорне це до `agent:<currentAgent>:main`.
  * Якщо ви введете `/session agent:other:main`, ви явно перемкнетеся на сесію цього агента.

* Область сесії:
  * `per-sender` (за замовчуванням): кожен агент має багато сесій.
  * `global`: TUI завжди використовує сесію `global` (вибір може бути порожнім).

* Поточний агент + сесія завжди видимі в нижньому колонтитулі.

* Щоб показувати хост Gateway для нелокальних підключень із URL, увімкніть це так:

  ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
  openclaw config set tui.footer.showRemoteHost true
  ```

  Loopback і вбудовані локальні підключення ніколи не показують мітку хоста.

* Якщо сесія має [ціль](/uk/tools/goal), нижній колонтитул показує її компактний стан,
  наприклад `Pursuing goal`, `Goal paused (/goal resume)` або
  `Goal achieved`.

* Коли TUI у режимі Gateway запускається без `--session`, він відновлює останню вибрану сесію для того самого Gateway, агента й області сесії, якщо ця сесія ще існує. Передавання `--session`, `/session`, `/new` або `/reset` залишається явним.

## Надсилання + доставлення

* Повідомлення надсилаються до Gateway; доставлення постачальникам за замовчуванням вимкнене.
* TUI — це внутрішня поверхня джерела, як WebChat, а не універсальний вихідний канал. Оснастки, яким потрібен `tools.message` для видимих відповідей, можуть задовольнити активний хід TUI через `message.send` без цілі; явне доставлення постачальнику й далі використовує звичайні налаштовані канали й ніколи не повертається до `lastChannel`.
* Увімкніть доставлення:
  * `/deliver on`
  * або панель налаштувань
  * або запустіть з `openclaw tui --deliver`

## Вибірники + накладання

* Вибірник моделі: перелічує доступні моделі й задає перевизначення сесії.
* Вибірник агента: вибирає іншого агента.
* Вибірник сесії: показує до 50 сесій для поточного агента, оновлених за останні 7 днів. Використовуйте `/session <key>`, щоб перейти до старішої відомої сесії.
* Налаштування: перемикає доставлення, розгортання виводу інструментів і видимість міркування.

## Комбінації клавіш

* Enter: надіслати повідомлення
* Esc: перервати активний запуск
* Ctrl+C: очистити введення (натисніть двічі, щоб вийти)
* Ctrl+D: вийти
* Ctrl+L: вибірник моделі
* Ctrl+G: вибірник агента
* Ctrl+P: вибірник сесії
* Ctrl+O: перемкнути розгортання виводу інструментів
* Ctrl+T: перемкнути видимість міркування (перезавантажує історію)

## Slash-команди

Ядро:

* `/help`
* `/status`
* `/agent <id>` (або `/agents`)
* `/session <key>` (або `/sessions`)
* `/model <provider/model>` (або `/models`)

Керування сесією:

* `/think <off|minimal|low|medium|high>`
* `/fast <status|on|off>`
* `/verbose <on|full|off>`
* `/trace <on|off>`
* `/reasoning <on|off|stream>`
* `/usage <off|tokens|full|reset>` (`reset`/`inherit`/`clear`/`default` очищає перевизначення сесії)
* `/goal [status] | /goal start <objective> | /goal pause|resume|complete|block|clear`
* `/elevated <on|off|ask|full>` (псевдонім: `/elev`)
* `/activation <mention|always>`
* `/deliver <on|off>`

Життєвий цикл сесії:

* `/new` або `/reset` (скинути сесію)
* `/abort` (перервати активний запуск)
* `/settings`
* `/exit`

Лише локальний режим:

* `/auth [provider]` відкриває потік автентифікації/входу постачальника всередині TUI.

Інші Slash-команди Gateway (наприклад, `/context`) пересилаються до Gateway і показуються як системний вивід. Див. [Slash-команди](/uk/tools/slash-commands).

## Локальні команди оболонки

* Додайте на початку рядка `!`, щоб виконати локальну команду оболонки на хості TUI.
* TUI один раз за сесію запитує дозвіл на локальне виконання; відмова залишає `!` вимкненим для сесії.
* Команди виконуються в новій неінтерактивній оболонці в робочому каталозі TUI (без постійних `cd`/env).
* Локальні команди оболонки отримують `OPENCLAW_SHELL=tui-local` у своєму середовищі.
* Окремий `!` надсилається як звичайне повідомлення; початкові пробіли не запускають локальне виконання.

## Ремонт конфігурацій з локального TUI

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

Якщо `openclaw config validate` вже завершується з помилкою, спочатку запустіть `openclaw configure`
або `openclaw doctor --fix`. `openclaw chat` не обходить захист від недійсної
конфігурації.

Типовий цикл:

1. Запустіть локальний режим:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw chat
```

2. Попросіть агента перевірити потрібне, наприклад:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
Compare my gateway auth config with the docs and suggest the smallest fix.
```

3. Використовуйте локальні команди оболонки для точних доказів і валідації:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
!openclaw config file
!openclaw docs gateway auth token secretref
!openclaw config validate
!openclaw doctor
```

4. Застосуйте вузькі зміни через `openclaw config set` або `openclaw configure`, потім повторно запустіть `!openclaw config validate`.
5. Якщо Doctor рекомендує автоматичну міграцію або ремонт, перегляньте це й запустіть `!openclaw doctor --fix`.

Поради:

* Віддавайте перевагу `openclaw config set` або `openclaw configure` замість ручного редагування `openclaw.json`.
* `openclaw docs "<query>"` шукає в живому індексі документації з тієї самої машини.
* `openclaw config validate --json` корисний, коли потрібні структурована схема й помилки SecretRef/можливості розв’язання.

## Вивід інструментів

* Виклики інструментів показуються як картки з аргументами + результатами.
* Ctrl+O перемикає між згорнутим і розгорнутим поданнями.
* Поки інструменти виконуються, часткові оновлення потоково надходять у ту саму картку.

## Кольори термінала

* TUI залишає основний текст асистента у стандартному кольорі переднього плану вашого термінала, щоб і темні, і світлі термінали лишалися читабельними.
* Якщо ваш термінал використовує світле тло, а автоматичне визначення помиляється, задайте `OPENCLAW_THEME=light` перед запуском `openclaw tui`.
* Щоб натомість примусово використати початкову темну палітру, задайте `OPENCLAW_THEME=dark`.

## Історія + потокове передавання

* Під час підключення TUI завантажує найновішу історію (за замовчуванням 200 повідомлень).
* Потокові відповіді оновлюються на місці до завершення.
* TUI також слухає події інструментів агента для багатших карток інструментів.

## Деталі підключення

* TUI реєструється в Gateway як `mode: "tui"`.
* Повторні підключення показують системне повідомлення; прогалини в подіях відображаються в журналі.

## Параметри

* `--local`: запускати проти локального вбудованого середовища виконання агента
* `--url <url>`: URL WebSocket Gateway (за замовчуванням з конфігурації або `ws://127.0.0.1:<port>`)
* `--token <token>`: токен Gateway (якщо потрібен)
* `--password <password>`: пароль Gateway (якщо потрібен)
* `--session <key>`: ключ сесії (за замовчуванням: `main`, або `global`, коли область глобальна)
* `--deliver`: доставляти відповіді асистента постачальнику (за замовчуванням вимкнено)
* `--thinking <level>`: перевизначити рівень міркування для надсилань
* `--message <text>`: надіслати початкове повідомлення після підключення
* `--timeout-ms <ms>`: тайм-аут агента в мс (за замовчуванням `agents.defaults.timeoutSeconds`)
* `--history-limit <n>`: записи історії для завантаження (за замовчуванням `200`)

<Warning>
  Коли ви задаєте `--url`, TUI не повертається до облікових даних із конфігурації або середовища. Передайте `--token` або `--password` явно. Відсутність явних облікових даних є помилкою. У локальному режимі не передавайте `--url`, `--token` або `--password`.
</Warning>

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

Немає виводу після надсилання повідомлення:

* Запустіть `/status` у TUI, щоб підтвердити, що Gateway підключений і в стані очікування/зайнятий.
* Перевірте журнали Gateway: `openclaw logs --follow`.
* Підтвердьте, що агент може запускатися: `openclaw status` і `openclaw models status`.
* Якщо ви очікуєте повідомлення в каналі чату, увімкніть доставлення (`/deliver on` або `--deliver`).

## Усунення несправностей підключення

* `disconnected`: переконайтеся, що Gateway запущений, а ваші `--url/--token/--password` правильні.
* Немає агентів у вибірнику: перевірте `openclaw agents list` і вашу конфігурацію маршрутизації.
* Порожній вибірник сесій: можливо, ви в глобальній області або ще не маєте сесій.

## Пов’язане

* [Інтерфейс керування](/uk/web/control-ui) — вебінтерфейс керування
* [Конфігурація](/uk/cli/config) — перевірка, валідація та редагування `openclaw.json`
* [Doctor](/uk/cli/doctor) — керований ремонт і перевірки міграції
* [Довідник CLI](/uk/cli) — повний довідник команд CLI