TUI

Быстрый старт

Режим Gateway

1. Запустите Gateway.

openclaw gateway

2. Откройте TUI.

openclaw tui

3. Введите сообщение и нажмите Enter.

Удаленный Gateway:

openclaw tui --url ws://<host>:<port> --token <gateway-token>

Используйте --password, если ваш Gateway использует аутентификацию по паролю.

Локальный режим

Запустите TUI без Gateway:

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, включите это явно:

  openclaw config set tui.footer.showRemoteHost true

  Подключения через loopback и встроенные локальные подключения никогда не показывают метку хоста.

• Если у сессии есть цель, нижняя панель показывает ее компактное состояние, например 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-команды.

Локальные команды оболочки

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

Восстановление конфигураций из локального TUI

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

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

Типичный цикл:

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

openclaw chat

2. Спросите агента, что нужно проверить, например:

Сравни мою конфигурацию аутентификации gateway с документацией и предложи минимальное исправление.

3. Используйте локальные команды оболочки для точных доказательств и проверки:

!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)

Устранение неполадок

Нет вывода после отправки сообщения:

• Выполните /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 — веб-интерфейс управления
• Config — просмотр, проверка и редактирование openclaw.json
• Doctor — управляемое восстановление и проверки миграции
• Справочник CLI — полный справочник команд CLI