openclaw chat и openclaw terminal — псевдонимы для openclaw tui --local.
--local нельзя использовать вместе с --url, --token или --password.
Локальный режим напрямую использует встроенную среду выполнения агента. Большинство локальных инструментов работают, но функции, доступные только через Gateway, недоступны.
Команда openclaw без подкоманды выбирает цель автоматически: при ненастроенной установке запускается первоначальная настройка инференса; при недопустимой конфигурации открываются классические рекомендации Doctor; если настроенный Gateway доступен, эта оболочка TUI открывается в режиме Gateway; в противном случае при наличии настроенной локальной модели она открывается в локальном режиме.
Журнал чата: сообщения пользователя, ответы ассистента, системные уведомления, карточки инструментов.
Строка состояния: состояние подключения или выполнения (подключение, выполнение, потоковая передача, ожидание, ошибка).
Нижняя строка: агент + сеанс + модель + состояние цели + 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
Значение по умолчанию — false. Для подключений через loopback и встроенных локальных подключений метка хоста никогда не отображается.
Если у сеанса есть цель, в нижней строке отображается её компактное состояние:
Pursuing goal, Goal paused (/goal resume), Goal blocked (/goal resume) или Goal achieved.
При запуске без --session TUI в режиме Gateway возобновляет последний выбранный сеанс для того же Gateway, агента и области сеансов, если этот сеанс всё ещё существует. Передача --session, /session, /new или /reset по-прежнему считается явным выбором.
Сообщения всегда отправляются в Gateway (или во встроенную среду выполнения в локальном режиме); доставка ответа ассистента обратно провайдеру чата — отдельный этап, по умолчанию отключённый.
TUI — это внутренняя поверхность источника, аналогичная WebChat, а не универсальный исходящий канал. Среды выполнения, которым для видимых ответов требуется tools.message, могут завершить активный ход TUI с помощью message.send без цели; явная доставка провайдеру по-прежнему использует обычные настроенные каналы и никогда не переключается на lastChannel.
Настройка доставки фиксируется на весь сеанс TUI при запуске: чтобы включить её, запустите TUI с openclaw tui --deliver. Команды с косой чертой /deliver и переключателя в Settings для изменения этой настройки во время сеанса нет; чтобы изменить её, перезапустите TUI.
Выбор модели: просмотр доступных моделей и задание переопределения для сеанса.
Выбор агента: выбор другого агента.
Выбор сеанса: отображает до 50 сеансов текущего агента, обновлённых за последние 7 дней. Используйте /session <key>, чтобы перейти к более старому известному сеансу.
Settings (/settings): переключение развёрнутого вывода инструментов и видимости процесса рассуждения. Эта панель не управляет доставкой.
OpenClaw — это помощник нулевого уровня по настройке и восстановлению, доступный как openclaw setup после успешной проверки настроенной модели по умолчанию с реальным инференсом. Если инференс недоступен, интерактивный запуск возвращает к первоначальной настройке инференса, а автоматизация завершается ошибкой с рекомендациями по восстановлению. Он работает в той же локальной оболочке TUI, что и openclaw tui --local, и использует ИИ-агента, ограниченного типизированными операциями OpenClaw, требующими подтверждения:
openclaw setup # интерактивный запускopenclaw setup -m "status" # выполнить один запрос и выйтиopenclaw setup -m "set default model openai/gpt-5.2" --yes # применить запись конфигурации
Постоянные изменения конфигурации требуют подтверждения: подтвердите их интерактивно или передайте --yes.
--json выводит начальный обзор в формате JSON вместо запуска чата.
Внутри OpenClaw запрос open-tui (например, просьба перейти к обычному агенту) завершает OpenClaw и открывает обычный TUI агента; чтобы вернуться, используйте там /openclaw.
Используйте локальный режим, когда текущая конфигурация уже проходит проверку и требуется, чтобы встроенный агент проверил её на той же машине, сравнил с документацией и помог устранить расхождения без зависимости от работающего Gateway.Если openclaw config validate уже завершается с ошибкой, сначала запустите openclaw configure или openclaw doctor --fix; для запуска openclaw chat всё равно требуется загружаемая конфигурация.Типичный цикл:
Запустите локальный режим:
openclaw chat
Сообщите агенту, что требуется проверить, например:
Сравни конфигурацию аутентификации моего Gateway с документацией и предложи минимальное исправление.
Используйте команды локальной оболочки для получения точных данных и проверки:
TUI отображает основной текст ответов ассистента цветом переднего плана терминала по умолчанию, поэтому текст остаётся читаемым как в тёмных, так и в светлых терминалах.
Если в терминале используется светлый фон и автоопределение работает неверно, задайте OPENCLAW_THEME=light перед запуском openclaw tui.
Чтобы вместо этого принудительно использовать исходную тёмную палитру, задайте OPENCLAW_THEME=dark.
--tls-fingerprint <sha256>: Ожидаемый отпечаток TLS-сертификата для Gateway с закреплённым wss://
--session <key>: Ключ сеанса (по умолчанию: main или global, если область действия глобальная)
--deliver: Доставлять ответы ассистента провайдеру (по умолчанию отключено)
--thinking <level>: Переопределить уровень рассуждений для отправок
--message <text>: Отправить начальное сообщение после подключения
--timeout-ms <ms>: Время ожидания агента в мс (по умолчанию — agents.defaults.timeoutSeconds)
--history-limit <n>: Количество загружаемых записей истории (по умолчанию — 200)
Если задано --url, TUI не использует резервные учётные данные из конфигурации или переменных среды. Явно передайте --token или --password, а также --tls-fingerprint, если целевой узел использует закреплённый сертификат. Отсутствие явно указанных учётных данных является ошибкой. В локальном режиме не передавайте --url, --token, --password или --tls-fingerprint.
Убедитесь, что агент может запускаться: openclaw status и openclaw models status.
Если сообщения должны появляться в канале чата, убедитесь, что TUI был запущен с --deliver (включить этот параметр позднее без перезапуска невозможно).
