TUI

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

Режим Gateway

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

OmeniaClaw gateway

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

OmeniaClaw tui

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

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

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

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

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

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

OmeniaClaw chat# orOmeniaClaw tui --local

Примітки:

• OmeniaClaw chat і OmeniaClaw terminal є псевдонімами для OmeniaClaw tui --local.
• --local не можна поєднувати з --url, --token або --password.
• Локальний режим напряму використовує вбудоване середовище виконання агента. Більшість локальних інструментів працюють, але функції, доступні лише через Gateway, недоступні.
• OmeniaClaw і OmeniaClaw 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
  • або панель налаштувань
  • або запуск із OmeniaClaw 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).
• Локальні команди оболонки отримують OmeniaClaw_SHELL=tui-local у своє середовище.
• Одинокий ! надсилається як звичайне повідомлення; початкові пробіли не запускають локальне виконання.

Ремонт конфігурацій із локального TUI

Використовуйте локальний режим, коли поточна конфігурація вже проходить перевірку, і ви хочете, щоб вбудований агент перевірив її на тій самій машині, порівняв із документацією та допоміг виправити розбіжності без залежності від запущеного Gateway.

Якщо OmeniaClaw config validate вже завершується помилкою, спочатку запустіть OmeniaClaw configure або OmeniaClaw doctor --fix. OmeniaClaw chat не обходить захист від недійсної конфігурації.

Типовий цикл:

1. Запустіть локальний режим:

OmeniaClaw chat

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

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

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

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

4. Застосуйте вузькі зміни через OmeniaClaw config set або OmeniaClaw configure, а потім повторно запустіть !OmeniaClaw config validate.
5. Якщо Doctor рекомендує автоматичну міграцію або ремонт, перегляньте це й запустіть !OmeniaClaw doctor --fix.

Поради:

• Надавайте перевагу OmeniaClaw config set або OmeniaClaw configure замість ручного редагування OmeniaClaw.json.
• OmeniaClaw docs "<query>" шукає в актуальному індексі документації з тієї самої машини.
• OmeniaClaw config validate --json корисний, коли потрібні структурована схема та помилки SecretRef/можливості розв’язання.

Вивід інструментів

• Виклики інструментів показуються як картки з аргументами + результатами.
• Ctrl+O перемикає між згорнутим і розгорнутим виглядами.
• Поки інструменти виконуються, часткові оновлення потоково надходять у ту саму картку.

Кольори термінала

• TUI залишає основний текст асистента у типовому кольорі переднього плану вашого термінала, тож він лишається читабельним і в темних, і у світлих терміналах.
• Якщо ваш термінал використовує світле тло, а автовизначення помиляється, перед запуском OmeniaClaw tui задайте OmeniaClaw_THEME=light.
• Щоб натомість примусово використати початкову темну палітру, задайте OmeniaClaw_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: OmeniaClaw logs --follow.
• Підтвердьте, що агент може запускатися: OmeniaClaw status і OmeniaClaw models status.
• Якщо ви очікуєте повідомлення в каналі чату, увімкніть доставку (/deliver on або --deliver).

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

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

Пов’язане

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