> ## 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
# или
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 и встроенные локальные подключения никогда не показывают метку хоста.

* Если у сессии есть [цель](/ru/tools/goal), нижняя панель показывает ее компактное состояние,
  например `Pursuing goal`, `Goal paused (/goal resume)` или
  `Goal achieved`.

* При запуске без `--session` TUI в режиме Gateway возобновляет последнюю выбранную сессию для того же 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-команды](/ru/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"}}
Сравни мою конфигурацию аутентификации gateway с документацией и предложи минимальное исправление.
```

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` и вашу конфигурацию маршрутизации.
* Пустой выбор сессий: возможно, вы находитесь в глобальной области действия или у вас пока нет сессий.

## Связанные разделы

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