Інтерфейс керування

• Спілкуватися з моделлю через Gateway WS (chat.history, chat.send, chat.abort, chat.inject).
• Оновлення історії чату запитують обмежене недавнє вікно з лімітами тексту для кожного повідомлення, щоб великі сесії не змушували браузер рендерити повне навантаження розмови до того, як чат стане придатним до використання.
• Розмовляти через realtime-сесії браузера. OpenAI використовує прямий WebRTC, Google Live використовує обмежений одноразовий браузерний токен через WebSocket, а backend-only realtime-голосові plugins використовують relay-транспорт Gateway. Сесії провайдера, якими володіє клієнт, починаються з talk.client.create; relay-сесії Gateway починаються з talk.session.create. Relay утримує облікові дані провайдера на Gateway, поки браузер транслює мікрофонний PCM через talk.session.appendAudio, пересилає виклики інструментів провайдера openclaw_agent_consult через talk.client.toolCall для політики Gateway і більшої налаштованої моделі OpenClaw, а також маршрутизує голосове керування активним запуском через talk.client.steer або talk.session.steer.
• Транслювати виклики інструментів і live-картки виводу інструментів у чаті (події агента).
• Вкладка активності з локальними для браузера, орієнтованими на редагування зведеннями live-активності інструментів з наявної доставки подій session.tool / інструментів.

• Канали: статус вбудованих і пакетних/зовнішніх каналів plugin, QR-вхід і конфігурація для кожного каналу (channels.status, web.login.*, config.patch).
• Оновлення зондування каналів залишають попередній знімок видимим, поки повільні перевірки провайдера завершуються, а часткові знімки позначаються, коли зондування або аудит перевищує свій бюджет UI.
• Екземпляри: список присутності + оновлення (system-presence).
• Сесії: типово перелічувати сесії налаштованих агентів, закріплювати часті сесії, перейменовувати їх, архівувати або відновлювати неактивні сесії, відступати від застарілих ключів сесій неналаштованих агентів і застосовувати для кожної сесії перевизначення моделі/мислення/швидкого режиму/докладності/трасування/міркування (sessions.list, sessions.patch). Закріплені сесії сортуються вище за недавні незакріплені сесії; архівовані сесії розташовані в архівному поданні сторінки сесій і зберігають свої розмови.
• Сни: статус Dreaming, перемикач увімкнення/вимкнення та читач Dream Diary (doctor.memory.status, doctor.memory.dreamDiary, config.patch).

• Завдання Cron: перелік/додавання/редагування/запуск/увімкнення/вимкнення + історія запусків (cron.*).
• Skills: статус, увімкнення/вимкнення, встановлення, оновлення ключів API (skills.*).
• Вузли: перелік + можливості (node.list), створення мобільних кодів налаштування та схвалення сполучення пристроїв (device.pair.*).
• Схвалення exec: редагування списків дозволів Gateway або вузла + політика запиту для exec host=gateway/node (exec.approvals.*).

• Переглядайте/редагуйте ~/.openclaw/openclaw.json (config.get, config.set).
• MCP має окрему сторінку налаштувань для налаштованих серверів, увімкнення, підсумків OAuth/фільтрів/паралельного виконання, поширених команд оператора та редактора конфігурації mcp з обмеженою областю дії.
• Застосовуйте + перезапускайте з валідацією (config.apply) і пробуджуйте останній активний сеанс.
• Записи містять захист на основі базового хеша, щоб запобігти перезапису паралельних змін.
• Записи (config.set/config.apply/config.patch) попередньо перевіряють розв’язання активних SecretRef для посилань у надісланому корисному навантаженні конфігурації; нерозв’язані активні надіслані посилання відхиляються перед записом.
• Збереження форми відкидає застарілі відредаговані заповнювачі, які не можна відновити зі збереженої конфігурації, водночас зберігаючи відредаговані значення, які досі відповідають збереженим секретам.
• Схема + рендеринг форми (config.schema / config.schema.lookup, включно з полями title / description, відповідними підказками UI, підсумками безпосередніх дочірніх елементів, метаданими документації на вкладених вузлах object/wildcard/array/composition, а також схемами plugin + каналу, коли вони доступні); редактор Raw JSON доступний лише тоді, коли знімок має безпечний необроблений цикл читання-запису.
• Якщо знімок не може безпечно виконати цикл читання-запису необробленого тексту, Control UI примусово вмикає режим форми та вимикає режим Raw для цього знімка.
• Редактор Raw JSON "Скинути до збереженого" зберігає форму, створену в raw-режимі (форматування, коментарі, компонування $include), замість повторного рендерингу сплощеного знімка, тож зовнішні редагування переживають скидання, коли знімок може безпечно виконати цикл читання-запису.
• Структуровані значення об’єктів SecretRef відображаються лише для читання в текстових полях форми, щоб запобігти випадковому пошкодженню через перетворення об’єкта на рядок.

• Налагодження: знімки стану/працездатності/моделей + журнал подій + ручні RPC-виклики (status, health, models.list).
• Журнал подій містить таймінги оновлення/RPC Control UI, таймінги повільного рендерингу чату/конфігурації та записи чутливості браузера для довгих кадрів анімації або довгих завдань, коли браузер надає ці типи записів PerformanceObserver.
• Журнали: live tail файлових журналів gateway з фільтром/експортом (logs.tail).
• Оновлення: запустіть оновлення пакета/git + перезапуск (update.run) зі звітом про перезапуск, потім опитуйте update.status після повторного підключення, щоб перевірити запущену версію gateway.

• Для ізольованих завдань доставка за замовчуванням оголошує підсумок. Можна перемкнути на none, якщо потрібні лише внутрішні запуски.
• Поля каналу/цілі з’являються, коли вибрано оголошення.
• Режим Webhook використовує delivery.mode = "webhook" з delivery.to, установленим на дійсну HTTP(S) URL-адресу webhook.
• Для завдань основного сеансу доступні режими доставки webhook і none.
• Розширені елементи керування редагуванням включають видалення після запуску, очищення перевизначення агента, точні/зміщені параметри cron, перевизначення моделі/мислення агента та перемикачі доставки за принципом найкращих зусиль.
• Валідація форми вбудована з помилками на рівні полів; недійсні значення вимикають кнопку збереження, доки їх не буде виправлено.
• Установіть cron.webhookToken, щоб надсилати окремий bearer-токен; якщо його пропущено, webhook надсилається без заголовка автентифікації.
• Застарілий fallback: запустіть openclaw doctor --fix, щоб мігрувати збережені застарілі завдання з notify: true з cron.webhook до явної доставки через webhook для кожного завдання або доставки після завершення.

• chat.send є неблокувальним: він негайно підтверджує отримання через { runId, status: "started" }, а відповідь передається потоком через події chat. Довірені клієнти Control UI також можуть отримувати необов’язкові метадані часу ACK для локальної діагностики.
• Завантаження в чат приймають зображення та невідеофайли. Зображення зберігають нативний шлях до зображення; інші файли зберігаються як керовані медіа й показуються в історії як посилання на вкладення.
• Повторне надсилання з тим самим idempotencyKey повертає { status: "in_flight" } під час виконання і { status: "ok" } після завершення.
• Відповіді chat.history обмежені за розміром для безпеки UI. Коли записи транскрипту завеликі, Gateway може скорочувати довгі текстові поля, пропускати важкі блоки метаданих і замінювати завеликі повідомлення заповнювачем ([chat.history omitted: message too large]).
• Коли видиме повідомлення асистента було скорочене в chat.history, бічний читач може на вимогу отримати повний нормалізований для відображення запис транскрипту через chat.message.get за sessionKey, активним agentId, коли потрібно, і messageId транскрипту. Якщо Gateway усе ще не може повернути більше, читач показує явний стан недоступності замість тихого повторення скороченого попереднього перегляду.
• Зображення, створені асистентом або генерацією, зберігаються як керовані медіапосилання і повертаються через автентифіковані медіа-URL Gateway, тож перезавантаження не залежать від збереження сирих base64-пейлоадів зображень у відповіді історії чату.
• Під час рендерингу chat.history Control UI вилучає з видимого тексту асистента лише-для-відображення inline-теги директив (наприклад [[reply_to_*]] і [[audio_as_voice]]), plain-text XML-пейлоади викликів інструментів (зокрема <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls> і скорочені блоки викликів інструментів), а також витеклі ASCII/повноширинні керівні токени моделі, і пропускає записи асистента, весь видимий текст яких є лише точним silent-токеном NO_REPLY / no_reply або токеном підтвердження Heartbeat HEARTBEAT_OK.
• Під час активного надсилання і фінального оновлення історії подання чату зберігає локальні оптимістичні повідомлення користувача/асистента видимими, якщо chat.history ненадовго повертає старіший знімок; канонічний транскрипт замінює ці локальні повідомлення, щойно історія Gateway наздоганяє.
• Живі події chat є станом доставки, тоді як chat.history перебудовується з довготривалого транскрипту сесії. Після фінальних подій інструментів Control UI перезавантажує історію і зливає лише невеликий оптимістичний хвіст; межу транскрипту задокументовано в WebChat.
• chat.inject додає нотатку асистента до транскрипту сесії та транслює подію chat для оновлень лише в UI (без запуску агента, без доставки каналом).
• Бічна панель показує останні сесії з дією Нова сесія, посиланням Усі сесії та кнопкою пошуку сесій, яка відкриває повний вибір сесії (обмежений вибраним агентом, із пошуком і пагінацією). Перемикання агентів показує лише сесії, пов’язані з цим агентом, і повертається до головної сесії цього агента, якщо в нього ще немає збережених сесій панелі керування.
• Кожен рядок вибору сесії може перейменувати, закріпити або архівувати сесію. Активний запуск і головну сесію агента не можна архівувати. Архівування поточної вибраної сесії перемикає чат назад на головну сесію цього агента.
• На десктопних ширинах елементи керування чатом залишаються в одному компактному рядку і згортаються під час прокручування транскрипту вниз; прокручування вгору, повернення на початок або досягнення низу відновлює елементи керування.
• Послідовні дублікати текстових повідомлень відображаються як одна бульбашка з бейджем кількості. Повідомлення, що містять зображення, вкладення, вивід інструментів або попередні перегляди полотна, не згортаються.
• Перемикачі моделі й thinking у заголовку чату негайно виправляють активну сесію через sessions.patch; це сталі перевизначення сесії, а не параметри надсилання лише для одного ходу.
• Якщо ви надсилаєте повідомлення, поки зміна перемикача моделі для тієї самої сесії ще зберігається, композер чекає на цей патч сесії перед викликом chat.send, щоб надсилання використало вибрану модель.
• Введення /new у Control UI створює та перемикає на таку саму свіжу сесію панелі керування, як Новий чат, окрім випадку, коли налаштовано session.dmScope: "main" і поточний батьківський об’єкт є головною сесією агента; у такому разі він скидає головну сесію на місці. Введення /reset зберігає явне скидання Gateway на місці для поточної сесії.
• Перемикач моделі чату запитує налаштоване подання моделей Gateway. Якщо присутній agents.defaults.models, цей allowlist керує перемикачем, зокрема записами provider/*, які залишають каталоги з областю дії провайдера динамічними. Інакше перемикач показує явні записи models.providers.*.models плюс провайдерів із придатною автентифікацією. Повний каталог лишається доступним через налагоджувальний RPC models.list з view: "all".
• Коли свіжі звіти Gateway про використання сесії містять поточні токени контексту, панель інструментів композера чату показує невелике кільце використання контексту з відсотком використання; повна деталізація токенів міститься в його підказці. Кільце перемикається на стиль попередження за високого тиску контексту і, на рекомендованих рівнях Compaction, показує компактну кнопку, яка запускає звичайний шлях Compaction сесії. Застарілі знімки токенів приховані, доки Gateway знову не повідомить свіже використання.

Режим розмови використовує зареєстрованого realtime-провайдера голосу. Налаштуйте OpenAI з talk.realtime.provider: "openai" плюс профілем автентифікації API-ключа openai, talk.realtime.providers.openai.apiKey або OPENAI_API_KEY; OAuth-профілі OpenAI не налаштовують Realtime-голос. Налаштуйте Google з talk.realtime.provider: "google" плюс talk.realtime.providers.google.apiKey. Браузер ніколи не отримує стандартний API-ключ провайдера. OpenAI отримує ефемерний клієнтський секрет Realtime для WebRTC. Google Live отримує одноразовий обмежений токен автентифікації Live API для браузерної WebSocket-сесії, з інструкціями та деклараціями інструментів, зафіксованими в токені Gateway. Провайдери, які надають лише backend realtime-міст, працюють через relay-транспорт Gateway, тож облікові дані та vendor-сокети залишаються на сервері, тоді як аудіо браузера рухається через автентифіковані RPC Gateway. Prompt Realtime-сесії збирається Gateway; talk.client.create не приймає надані викликачем перевизначення інструкцій.

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

У композиторі чату елемент керування розмовою — це кнопка з хвилями поруч із кнопкою диктування через мікрофон. Коли розмова починається, рядок стану композитора показує Connecting Talk..., потім Talk live, поки аудіо підключено, або Asking OpenClaw..., поки виклик інструмента в реальному часі консультується з налаштованою більшою моделлю через talk.client.toolCall.

Жива smoke-перевірка для супровідників: OPENAI_API_KEY=... GEMINI_API_KEY=... node --import tsx scripts/dev/realtime-talk-live-smoke.ts перевіряє серверний міст WebSocket OpenAI, браузерний обмін SDP WebRTC OpenAI, браузерне налаштування WebSocket Google Live з обмеженими токенами та браузерний адаптер ретрансляції Gateway із підробленим медіа мікрофона. Команда друкує лише стан постачальника й не журналює секрети.

• Натисніть Зупинити (викликає chat.abort).
• Поки виконання активне, звичайні наступні повідомлення стають у чергу. Натисніть Скерувати на повідомленні в черзі, щоб вставити це наступне повідомлення в поточний хід.
• Введіть /stop (або окремі фрази переривання, як-от stop, stop action, stop run, stop openclaw, please stop), щоб перервати поза основним каналом.
• chat.abort підтримує { sessionKey } (без runId), щоб перервати всі активні виконання для цього сеансу.

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

{  gateway: {    controlUi: { allowInsecureAuth: true },    bind: "tailnet",    auth: { mode: "token", token: "replace-me" },  },}

allowInsecureAuth — це лише локальний перемикач сумісності:

• Він дозволяє сеансам Control UI localhost продовжуватися без ідентичності пристрою в незахищених HTTP-контекстах.
• Він не обходить перевірки сполучення.
• Він не послаблює вимоги до ідентичності пристрою для віддалених (не localhost) з'єднань.

• Успішна автентифікація trusted-proxy може допускати операторські сеанси Control UI без ідентичності пристрою.
• Це не поширюється на сеанси Control UI з роллю вузла.
• Зворотні проксі same-host loopback усе ще не задовольняють автентифікацію trusted-proxy; див. Автентифікація довіреного проксі.

• gatewayUrl зберігається в localStorage після завантаження та видаляється з URL-адреси.
• Якщо ви передаєте повну кінцеву точку ws:// або wss:// через gatewayUrl, URL-кодуйте значення gatewayUrl, щоб браузер правильно розібрав рядок запиту.
• token слід передавати через фрагмент URL-адреси (#token=...), коли це можливо. Фрагменти не надсилаються на сервер, що запобігає витоку в журналах запитів і Referer. Застарілі параметри запиту ?token= усе ще імпортуються один раз для сумісності, але лише як fallback, і негайно видаляються після bootstrap.
• password зберігається лише в пам’яті.
• Коли gatewayUrl задано, UI не повертається до облікових даних із конфігурації або середовища. Надайте token (або password) явно. Відсутність явних облікових даних є помилкою.
• Використовуйте wss://, коли Gateway розташований за TLS (Tailscale Serve, HTTPS-проксі тощо).
• gatewayUrl приймається лише у вікні верхнього рівня (не у вбудованому), щоб запобігти clickjacking.
• Публічні нелупбек-розгортання Control UI повинні явно задавати gateway.controlUi.allowedOrigins (повні джерела). Приватні LAN/Tailnet-завантаження з тим самим джерелом із loopback, RFC1918/link-local, .local, .ts.net або хостів Tailscale CGNAT приймаються без увімкнення fallback за Host-заголовком.
• Запуск Gateway може ініціалізувати локальні джерела, як-от http://localhost:<port> і http://127.0.0.1:<port>, з ефективних runtime bind і порту, але віддалені джерела браузера все одно потребують явних записів.
• Не використовуйте gateway.controlUi.allowedOrigins: ["*"], окрім суворо контрольованого локального тестування. Це означає дозволити будь-яке джерело браузера, а не «зіставити будь-який хост, який я використовую».
• gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback=true вмикає режим fallback за Host-заголовком, але це небезпечний режим безпеки.