TUI

Швидкий старт

Режим Gateway

1. Запустіть Gateway.

openclaw gateway

2. Відкрийте TUI.

openclaw tui

3. Введіть повідомлення й натисніть Enter.

Віддалений Gateway:

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

Використовуйте --password, якщо ваш Gateway використовує автентифікацію паролем.

Локальний режим

Запустіть TUI без Gateway:

openclaw chat# oropenclaw 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.

• Коли TUI у режимі Gateway запускається без --session, він відновлює останню вибрану сесію для того самого 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

2. Попросіть агента перевірити потрібне, наприклад:

Compare my gateway auth config with the docs and suggest the smallest fix.

3. Використовуйте локальні команди оболонки для точних доказів і валідації:

!openclaw config file!openclaw docs gateway auth token secretref!openclaw config validate!openclaw doctor

4. Застосуйте вузькі зміни через openclaw config set або openclaw configure, потім повторно запустіть !openclaw config validate.
5. Якщо 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)

Усунення несправностей

Немає виводу після надсилання повідомлення:

• Запустіть /status у TUI, щоб підтвердити, що Gateway підключений і в стані очікування/зайнятий.
• Перевірте журнали Gateway: openclaw logs --follow.
• Підтвердьте, що агент може запускатися: openclaw status і openclaw models status.
• Якщо ви очікуєте повідомлення в каналі чату, увімкніть доставлення (/deliver on або --deliver).

Усунення несправностей підключення

• disconnected: переконайтеся, що Gateway запущений, а ваші --url/--token/--password правильні.
• Немає агентів у вибірнику: перевірте openclaw agents list і вашу конфігурацію маршрутизації.
• Порожній вибірник сесій: можливо, ви в глобальній області або ще не маєте сесій.

Пов’язане

• Інтерфейс керування — вебінтерфейс керування
• Конфігурація — перевірка, валідація та редагування openclaw.json
• Doctor — керований ремонт і перевірки міграції
• Довідник CLI — повний довідник команд CLI