---
read_when:
    - Вам потрібен зручний для початківців покроковий огляд TUI
    - Вам потрібен повний список функцій, команд і скорочень TUI
summary: 'Термінальний інтерфейс (TUI): підключіться до Gateway або запустіть локально у вбудованому режимі'
title: TUI
x-i18n:
    generated_at: "2026-06-27T18:31:57Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: ed02875ea5dcb8cef987d16fe11701eba11160525caf9791f74c610b1b6bec6e
    source_path: web/tui.md
    workflow: 16
---

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

### Режим Gateway

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

```bash
openclaw gateway
```

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

```bash
openclaw tui
```

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

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

```bash
openclaw tui --url ws://<host>:<port> --token <gateway-token>
```

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

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

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

```bash
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
  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
openclaw chat
```

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

```text
Compare my gateway auth config with the docs and suggest the smallest fix.
```

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

```text
!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