CLI commands
TUI
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 chatopenclaw tui --localopenclaw tuiopenclaw tui --url ws://127.0.0.1:18789 --token <token>openclaw tui --session main --deliveropenclaw chat --message "Compare my config to the docs and tell me what to fix"# when run inside an agent workspace, infers that agent automaticallyopenclaw tui --session bugfixЦикл исправления конфигурации
Используйте локальный режим, когда текущая конфигурация уже проходит проверку и вы хотите, чтобы встроенный агент проверил ее, сравнил с документацией и помог исправить ее из того же терминала:
Если openclaw config validate уже завершается с ошибкой, сначала используйте openclaw configure или
openclaw doctor --fix. openclaw chat не обходит защиту от недопустимой
конфигурации.
openclaw chatЗатем внутри TUI:
!openclaw config file!openclaw docs gateway auth token secretref!openclaw config validate!openclaw doctorПримените точечные исправления с помощью openclaw config set или openclaw configure, затем
повторно выполните openclaw config validate. См. TUI и Конфигурация.