Веб-интерфейсы

TUI

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

  1. Запустите Шлюз (Gateway).
openclaw gateway
  1. Откройте TUI.
openclaw tui
  1. Введите сообщение и нажмите Enter.

Удалённый Шлюз:

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

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

Что вы видите

  • Заголовок: URL подключения, текущий агент, текущая сессия.
  • Лог чата: сообщения пользователя, ответы ассистента, системные уведомления, карточки инструментов.
  • Строка состояния: состояние подключения/выполнения (подключение, выполнение, потоковая передача, бездействие, ошибка).
  • Подвал: состояние подключения + агент + сессия + модель + think/verbose/reasoning + счётчики токенов + deliver.
  • Ввод: текстовый редактор с автодополнением.

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

  • Агенты — это уникальные идентификаторы (например, main, research). Список предоставляется Шлюзом.
  • Сессии принадлежат текущему агенту.
  • Ключи сессий хранятся как agent:<agentId>:<sessionKey>.
    • Если вы введёте /session main, TUI развернёт это в agent:<currentAgent>:main.
    • Если вы введёте /session agent:other:main, вы явно переключитесь на сессию этого агента.
  • Область видимости сессии:
    • per-sender (по умолчанию): у каждого агента много сессий.
    • global: TUI всегда использует сессию global (селектор может быть пустым).
  • Текущий агент + сессия всегда отображаются в подвале.

Отправка + доставка (delivery)

  • Сообщения отправляются на Шлюз; доставка провайдерам по умолчанию отключена.
  • Включите доставку:
    • /deliver on
    • или в панели Настроек
    • или запустите с openclaw tui --deliver

Селекторы + оверлеи

  • Селектор модели: список доступных моделей и установка переопределения для сессии.
  • Селектор агента: выбор другого агента.
  • Селектор сессии: показывает только сессии для текущего агента.
  • Настройки: переключение доставки, развёртывания вывода инструментов и видимости размышлений (thinking).

Горячие клавиши

  • Enter: отправить сообщение
  • Esc: прервать активное выполнение
  • Ctrl+C: очистить ввод (нажмите дважды для выхода)
  • Ctrl+D: выход
  • Ctrl+L: селектор модели
  • Ctrl+G: селектор агента
  • Ctrl+P: селектор сессии
  • Ctrl+O: переключить развёртывание вывода инструментов
  • Ctrl+T: переключить видимость размышлений (перезагружает историю)

Слеш-команды

Основные:

  • /help
  • /status
  • /agent <id> (или /agents)
  • /session <key> (или /sessions)
  • /model <provider/model> (или /models)

Управление сессией:

  • /think <off|minimal|low|medium|high>
  • /verbose <on|full|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

Другие слеш-команды Шлюза (например, /context) перенаправляются на Шлюз и отображаются как системный вывод. См. Слеш-команды.

Локальные shell-команды

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

Вывод инструментов

  • Вызовы инструментов отображаются как карточки с аргументами и результатами.
  • Ctrl+O переключает между свёрнутым и развёрнутым видом.
  • Пока инструменты выполняются, частичные обновления передаются в ту же карточку.

История + потоковая передача

  • При подключении TUI загружает последнюю историю (по умолчанию 200 сообщений).
  • Потоковые ответы обновляются на месте до финализации.
  • TUI также прослушивает события инструментов агента для более информативных карточек инструментов.

Детали подключения

  • TUI регистрируется на Шлюзе как mode: "tui".
  • Переподключения отображаются системным сообщением; пропуски событий отображаются в логе.

Параметры

  • --url <url>: URL WebSocket Шлюза (по умолчанию из конфига или ws://127.0.0.1:<port>)
  • --token <token>: Токен Шлюза (если требуется)
  • --password <password>: Пароль Шлюза (если требуется)
  • --session <key>: Ключ сессии (по умолчанию: main, или global при глобальной области видимости)
  • --deliver: Доставлять ответы ассистента провайдеру (по умолчанию выключено)
  • --thinking <level>: Переопределить уровень размышлений (thinking) для отправок
  • --timeout-ms <ms>: Таймаут агента в мс (по умолчанию agents.defaults.timeoutSeconds)

Примечание: при установке --url TUI не возвращается к учётным данным из конфига или окружения. Передавайте --token или --password явно. Отсутствие явных учётных данных является ошибкой.

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

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

  • Выполните /status в TUI, чтобы подтвердить, что Шлюз подключён и находится в состоянии бездействия/занятости.
  • Проверьте логи Шлюза: openclaw logs --follow.
  • Убедитесь, что агент может выполняться: openclaw status и openclaw models status.
  • Если вы ожидаете сообщения в чат-канале, включите доставку (/deliver on или --deliver).
  • --history-limit <n>: Количество записей истории для загрузки (по умолчанию 200)

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

  • disconnected: убедитесь, что Шлюз запущен, а ваши --url/--token/--password верны.
  • Нет агентов в селекторе: проверьте openclaw agents list и вашу конфигурацию маршрутизации.
  • Пустой селектор сессий: возможно, вы находитесь в глобальной области видимости или у вас ещё нет сессий.

WebChat