--- read_when: - Вам нужно понятное для новичков пошаговое руководство по TUI - Вам нужен полный список функций, команд и сочетаний клавиш TUI summary: 'Terminal UI (TUI): подключение к Gateway или локальный запуск во встроенном режиме' title: TUI x-i18n: generated_at: "2026-06-28T23:57:16Z" 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://: --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 подключения, текущий агент, текущая сессия. - Журнал чата: сообщения пользователя, ответы ассистента, системные уведомления, карточки инструментов. - Строка состояния: состояние подключения/запуска (подключение, выполнение, потоковая передача, ожидание, ошибка). - Нижняя панель: агент + сессия + модель + состояние цели + think/fast/verbose/trace/reasoning + количество токенов + доставка. Когда включен `tui.footer.showRemoteHost`, удаленные подключения к Gateway также показывают хост подключения. - Ввод: текстовый редактор с автодополнением. ## Ментальная модель: агенты + сессии - Агенты — это уникальные слаги (например, `main`, `research`). Gateway предоставляет список. - Сессии принадлежат текущему агенту. - Ключи сессий хранятся как `agent::`. - Если вы введете `/session main`, TUI развернет это в `agent::main`. - Если вы введете `/session agent:other:main`, вы явно переключитесь на сессию этого агента. - Область действия сессии: - `per-sender` (по умолчанию): у каждого агента много сессий. - `global`: TUI всегда использует сессию `global` (выбор может быть пустым). - Текущие агент + сессия всегда видны в нижней панели. - Чтобы показывать хост Gateway для нелокальных подключений по URL, включите это явно: ```bash 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 `, чтобы перейти к более старой известной сессии. - Настройки: переключение доставки, раскрытия вывода инструментов и видимости размышлений. ## Сочетания клавиш - Enter: отправить сообщение - Esc: прервать активный запуск - Ctrl+C: очистить ввод (нажмите дважды для выхода) - Ctrl+D: выйти - Ctrl+L: выбор модели - Ctrl+G: выбор агента - Ctrl+P: выбор сессии - Ctrl+O: переключить раскрытие вывода инструментов - Ctrl+T: переключить видимость размышлений (перезагружает историю) ## Slash-команды Основные: - `/help` - `/status` - `/agent ` (или `/agents`) - `/session ` (или `/sessions`) - `/model ` (или `/models`) Управление сессией: - `/think ` - `/fast ` - `/verbose ` - `/trace ` - `/reasoning ` - `/usage ` (`reset`/`inherit`/`clear`/`default` очищает переопределение сессии) - `/goal [status] | /goal start | /goal pause|resume|complete|block|clear` - `/elevated ` (псевдоним: `/elev`) - `/activation ` - `/deliver ` Жизненный цикл сессии: - `/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 openclaw chat ``` 2. Спросите агента, что нужно проверить, например: ```text Сравни мою конфигурацию аутентификации gateway с документацией и предложи минимальное исправление. ``` 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 ""` выполняет поиск по актуальному индексу документации с той же машины. - `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 WebSocket Gateway (по умолчанию из конфигурации или `ws://127.0.0.1:`) - `--token `: токен Gateway (если требуется) - `--password `: пароль Gateway (если требуется) - `--session `: ключ сессии (по умолчанию: `main` или `global`, когда область действия глобальная) - `--deliver`: доставлять ответы ассистента провайдеру (по умолчанию отключено) - `--thinking `: переопределить уровень размышления для отправок - `--message `: отправить начальное сообщение после подключения - `--timeout-ms `: тайм-аут агента в мс (по умолчанию `agents.defaults.timeoutSeconds`) - `--history-limit `: количество записей истории для загрузки (по умолчанию `200`) Когда вы задаете `--url`, TUI не откатывается к учетным данным из конфигурации или окружения. Передайте `--token` или `--password` явно. Отсутствие явных учетных данных является ошибкой. В локальном режиме не передавайте `--url`, `--token` или `--password`. ## Устранение неполадок Нет вывода после отправки сообщения: - Выполните `/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