openclaw tui
Открывает терминальный UI, подключенный к Gateway, или запускает его в локальном встроенном
режиме.
Связано:
- Руководство по TUI: TUI
Параметры
| Флаг | По умолчанию | Описание |
|---|---|---|
--local | false | Запустить с локальным встроенным рантаймом агента вместо Gateway. |
--url <url> | gateway.remote.url из конфигурации | URL WebSocket для Gateway. |
--token <token> | (нет) | Токен Gateway, если требуется. |
--password <pass> | (нет) | Пароль Gateway, если требуется. |
--session <key> | main (или global, когда область глобальная) | Ключ сессии. Внутри рабочей области агента автоматически выбирает этого агента, если не задан префикс. |
--deliver | false | Доставлять ответы ассистента через настроенные каналы. |
--thinking <level> | (по умолчанию модели) | Переопределение уровня рассуждений. |
--message <text> | (нет) | Отправить начальное сообщение после подключения. |
--timeout-ms <ms> | agents.defaults.timeoutSeconds | Тайм-аут агента. Недопустимые значения записываются в журнал как предупреждение и игнорируются. |
--history-limit <n> | 200 | Количество записей истории для загрузки при подключении. |
openclaw chat и openclaw terminal вызывают ту же команду с подразумеваемым --local.
Примечания:
chatиterminalявляются алиасами дляopenclaw tui --local.--localнельзя сочетать с--url,--tokenили--password.tuiпо возможности разрешает настроенные SecretRefs аутентификации Gateway для аутентификации по токену/паролю (провайдерыenv/file/exec).- При запуске изнутри настроенного каталога рабочей области агента TUI автоматически выбирает этого агента как значение ключа сессии по умолчанию (если
--sessionявно не задан какagent:<id>:...). - Чтобы показывать имя хоста Gateway в нижнем колонтитуле для нелокальных подключений на основе URL, выполните
openclaw config set tui.footer.showRemoteHost true. Метка хоста отключена по умолчанию и никогда не отображается для loopback или встроенных локальных подключений. - Локальный режим использует встроенный рантайм агента напрямую. Большинство локальных инструментов работает, но функции, доступные только через Gateway, недоступны.
- Локальный режим добавляет
/auth [provider]в командную поверхность TUI. - Контуры подтверждения Plugin по-прежнему применяются в локальном режиме. Инструменты, которым требуется подтверждение, запрашивают решение в терминале; ничто не подтверждается автоматически без уведомления только потому, что Gateway не участвует.
- Цели сессии отображаются в нижнем колонтитуле, ими можно управлять с помощью
/goal.
Примеры
Цикл исправления конфигурации
Используйте локальный режим, когда текущая конфигурация уже проходит проверку и вы хотите, чтобы встроенный агент проверил ее, сравнил с документацией и помог исправить ее из того же терминала: Еслиopenclaw config validate уже завершается с ошибкой, сначала используйте openclaw configure или
openclaw doctor --fix. openclaw chat не обходит защиту от недопустимой
конфигурации.
openclaw config set или openclaw configure, затем
повторно выполните openclaw config validate. См. TUI и Конфигурация.