---
read_when:
    - Вам потрібен дружній до початківців покроковий посібник із TUI
    - Вам потрібен повний список можливостей, команд і клавіатурних скорочень TUI
summary: 'Термінальний UI (TUI): підключення до Gateway або локальний запуск у вбудованому режимі'
title: TUI
x-i18n:
    generated_at: "2026-04-23T23:09:28Z"
    model: gpt-5.4
    provider: openai
    source_hash: 6168ab6cec8e0069f660ddcfca03275c407b613b6eb756aa6ef7e97f2312effe
    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
# or
openclaw tui --local
```

Примітки:

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

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

- Заголовок: 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` (список вибору може бути порожнім).
- Поточний агент + сесія завжди видимі в нижньому колонтитулі.

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

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

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

- Вибірник моделі: показує доступні моделі та встановлює перевизначення для сесії.
- Вибірник агента: дає змогу вибрати іншого агента.
- Вибірник сесії: показує лише сесії для поточного агента.
- Settings: перемикає deliver, розгортання виводу інструментів і видимість thinking.

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

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

## 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>` (alias: `/elev`)
- `/activation <mention|always>`
- `/deliver <on|off>`

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

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

Лише в локальному режимі:

- `/auth [provider]` відкриває потік auth/login провайдера всередині TUI.

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

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

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

## Виправлення конфігурацій із локального 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. Використовуйте локальні команди 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>"` шукає в актуальному індексі документації з тієї самої машини.
- `openclaw config validate --json` корисна, коли вам потрібні структуровані помилки schema та SecretRef/resolvability.

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

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

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

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

## Історія + streaming

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

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

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

## Параметри

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

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

## Усунення проблем

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

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

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

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

## Пов’язане

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