Перейти к основному содержанию

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

​
Режим Gateway

  1. Запустите Gateway.
openclaw gateway
  1. Откройте TUI.
openclaw tui
  1. Введите сообщение и нажмите 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
  1. Спросите агента, что нужно проверить, например:
Сравни мою конфигурацию аутентификации gateway с документацией и предложи минимальное исправление.
  1. Используйте локальные команды оболочки для точных доказательств и проверки:
!openclaw config file
!openclaw docs gateway auth token secretref
!openclaw config validate
!openclaw doctor
  1. Примените точечные изменения с помощью openclaw config set или openclaw configure, затем повторно выполните !openclaw config validate.
  2. Если 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)
Когда вы задаете --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 — веб-интерфейс управления
  • Config — просмотр, проверка и редактирование openclaw.json
  • Doctor — управляемое восстановление и проверки миграции
  • Справочник CLI — полный справочник команд CLI