---
read_when:
    - Ви хочете покроковий огляд TUI, зручний для початківців
    - Вам потрібен повний список можливостей, команд і комбінацій клавіш TUI
summary: 'Термінальний інтерфейс (TUI): підключайтеся до Gateway або запускайте локально у вбудованому режимі'
title: TUI
x-i18n:
    generated_at: "2026-05-05T08:30:23Z"
    model: gpt-5.5
    provider: openai
    source_hash: 2b517ff434cc440aeffd8698df75d4d85c22a19e59b38a1f2383e58e1b4084ff
    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 + кількість токенів + deliver.
- Поле введення: текстовий редактор з автодоповненням.

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

- Агенти мають унікальні слаги (наприклад, `main`, `research`). Gateway надає список.
- Сесії належать поточному агенту.
- Ключі сесій зберігаються як `agent:<agentId>:<sessionKey>`.
  - Якщо ввести `/session main`, TUI розгорне це до `agent:<currentAgent>:main`.
  - Якщо ввести `/session agent:other:main`, ви явно перемкнетеся на сесію цього агента.
- Область сесій:
  - `per-sender` (типово): кожен агент має багато сесій.
  - `global`: TUI завжди використовує сесію `global` (засіб вибору може бути порожнім).
- Поточний агент + сесія завжди видимі в нижньому колонтитулі.
- Якщо TUI в режимі Gateway запущено без `--session`, він відновлює останню вибрану сесію для того самого Gateway, агента та області сесій, якщо ця сесія досі існує. Передавання `--session`, `/session`, `/new` або `/reset` залишається явним.

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

- Повідомлення надсилаються до Gateway; доставка провайдерам типово вимкнена.
- Увімкнути доставку:
  - `/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>`
- `/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 tui` задайте `OPENCLAW_THEME=light`.
- Щоб натомість примусово використати початкову темну палітру, задайте `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` і вашу конфігурацію маршрутизації.
- Порожній засіб вибору сесії: можливо, ви в глобальній області або ще не маєте сесій.

## Пов’язане

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