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
# or
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 + кількість токенів + deliver.
• Поле введення: текстовий редактор з автодоповненням.

# Ментальна модель: агенти + сесії

• Агенти мають унікальні слаги (наприклад, main, research). Gateway надає список.
• Сесії належать поточному агенту.
• Ключі сесій зберігаються як agent:<agentId>:<sessionKey>.
  • Якщо ввести /session main, TUI розгорне це до agent:<currentAgent>:main.
  • Якщо ввести /session agent:other:main, ви явно перемкнетеся на сесію цього агента.
• Область сесій:
  • per-sender (типово): кожен агент має багато сесій.
  • global: TUI завжди використовує сесію global (засіб вибору може бути порожнім).
• Поточний агент + сесія завжди видимі в нижньому колонтитулі.
• Якщо TUI в режимі Gateway запущено без --session, він відновлює останню вибрану сесію для того самого Gateway, агента та області сесій, якщо ця сесія досі існує. Передавання --session, /session, /new або /reset залишається явним.

# Надсилання + доставка

• Повідомлення надсилаються до Gateway; доставка провайдерам типово вимкнена.
• Увімкнути доставку:
  • /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>
• /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 tui задайте OPENCLAW_THEME=light.
• Щоб натомість примусово використати початкову темну палітру, задайте 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 і вашу конфігурацію маршрутизації.
• Порожній засіб вибору сесії: можливо, ви в глобальній області або ще не маєте сесій.

# Пов’язане

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