---
read_when:
    - Вам потрібен зрозумілий для початківців покроковий огляд TUI
    - Вам потрібен повний список можливостей, команд і клавіатурних скорочень TUI
summary: 'Термінальний інтерфейс користувача (TUI): підключення до Gateway або локальний запуск у вбудованому режимі'
title: TUI
x-i18n:
    generated_at: "2026-04-27T06:29:42Z"
    model: gpt-5.4
    provider: openai
    source_hash: 5caca4b3f4df02ce1226a8ed0d759023464e5b0752b9cd1b7922b20099d58df1
    source_path: web/tui.md
    workflow: 15
---

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

### Режим 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
# або
openclaw tui --local
```

Примітки:

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

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

- Заголовок: URL підключення, поточний агент, поточний сеанс.
- Журнал чату: повідомлення користувача, відповіді помічника, системні сповіщення, картки інструментів.
- Рядок стану: стан підключення/запуску (`connecting`, `running`, `streaming`, `idle`, `error`).
- Нижній колонтитул: стан підключення + агент + сеанс + модель + think/fast/verbose/trace/reasoning + лічильники токенів + deliver.
- Поле вводу: текстовий редактор з автодоповненням.

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

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

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

- Повідомлення надсилаються до Gateway; доставка провайдерам типово вимкнена.
- Увімкнути доставку:
  - `/deliver on`
  - або через панель Settings
  - або запустити з `openclaw tui --deliver`

## Picker-и + оверлеї

- Picker моделі: перелік доступних моделей і встановлення перевизначення для сеансу.
- Picker агента: вибір іншого агента.
- Picker сеансу: показує лише сеанси поточного агента.
- Settings: перемикання доставки, розгортання виводу інструментів і видимості thinking.

## Клавіатурні скорочення

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

## Команди зі скісною рискою

Основні:

- `/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.

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

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

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

## Виправлення конфігурацій з локального TUI

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

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

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

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

```bash
openclaw chat
```

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

```text
Порівняй мою конфігурацію автентифікації gateway з документацією і запропонуй найменше виправлення.
```

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

```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>"` виконує пошук у live-індексі документації з тієї самої машини.
- `openclaw config validate --json` корисно, коли вам потрібні структуровані помилки схеми та SecretRef/доступності.

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

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

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

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

## Історія + streaming

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

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

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

## Параметри

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

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

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

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

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

## Усунення проблем із підключенням

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

## Пов’язане

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