नियंत्रण UI

• Gateway WS के माध्यम से model से chat करें (chat.history, chat.send, chat.abort, chat.inject)।
• Chat history refreshes per-message text caps के साथ bounded recent window request करते हैं, ताकि बड़े sessions browser को chat usable होने से पहले full transcript payload render करने के लिए मजबूर न करें।
• Browser realtime sessions के माध्यम से talk करें। OpenAI direct WebRTC इस्तेमाल करता है, Google Live WebSocket पर constrained one-use browser token इस्तेमाल करता है, और backend-only realtime voice plugins Gateway relay transport इस्तेमाल करते हैं। Client-owned provider sessions talk.client.create से start होते हैं; Gateway relay sessions talk.session.create से start होते हैं। Relay provider credentials को Gateway पर रखता है जबकि browser microphone PCM को talk.session.appendAudio के माध्यम से stream करता है, openclaw_agent_consult provider tool calls को Gateway policy और बड़े configured OpenClaw model के लिए talk.client.toolCall के माध्यम से forward करता है, और active-run voice steering को talk.client.steer या talk.session.steer के माध्यम से route करता है।
• Chat में tool calls + live tool output cards stream करें (agent events)।
• Existing session.tool / tool event delivery से live tool activity की browser-local, redaction-first summaries वाला Activity tab।

• Channels: built-in plus bundled/external plugin channels status, QR login, और per-channel config (channels.status, web.login.*, config.patch)।
• Channel probe refreshes slow provider checks finish होने तक previous snapshot visible रखते हैं, और probe या audit अपने UI budget से exceed होने पर partial snapshots labeled होते हैं।
• Instances: presence list + refresh (system-presence)।
• Sessions: default रूप से configured-agent sessions सूचीबद्ध करें, frequent sessions pin करें, उनका नाम बदलें, inactive sessions archive या restore करें, stale unconfigured agent session keys से fall back करें, और per-session model/thinking/fast/verbose/trace/reasoning overrides apply करें (sessions.list, sessions.patch)। Pinned sessions recent unpinned sessions से ऊपर sort होते हैं; archived sessions Sessions page के archived view में रहते हैं और अपने transcripts रखते हैं।
• Dreams: dreaming status, enable/disable toggle, और Dream Diary reader (doctor.memory.status, doctor.memory.dreamDiary, config.patch)।

• Cron jobs: list/add/edit/run/enable/disable + run history (cron.*)।
• Skills: status, enable/disable, install, API key updates (skills.*)।
• Nodes: list + caps (node.list), mobile setup codes बनाएं, और device pairing approve करें (device.pair.*)।
• Exec approvals: gateway या node allowlists edit करें + exec host=gateway/node के लिए ask policy (exec.approvals.*)।

• ~/.openclaw/openclaw.json देखें/संपादित करें (config.get, config.set)।
• MCP में कॉन्फ़िगर किए गए सर्वरों, सक्षमकरण, OAuth/फ़िल्टर/समानांतर सारांशों, सामान्य ऑपरेटर कमांडों, और स्कोप किए गए mcp कॉन्फ़िग संपादक के लिए एक समर्पित सेटिंग पेज है।
• सत्यापन के साथ लागू करें + पुनरारंभ करें (config.apply) और अंतिम सक्रिय सत्र को जगाएं।
• समकालिक संपादनों को ओवरराइट होने से रोकने के लिए लिखाई में base-hash guard शामिल होता है।
• लिखाई (config.set/config.apply/config.patch) सबमिट किए गए कॉन्फ़िग payload में refs के लिए सक्रिय SecretRef resolution का preflight करती है; अनसुलझे सक्रिय सबमिट किए गए refs लिखाई से पहले अस्वीकार कर दिए जाते हैं।
• फ़ॉर्म सेव ऐसे पुराने redacted placeholders को हटाते हैं जिन्हें सेव किए गए कॉन्फ़िग से पुनर्स्थापित नहीं किया जा सकता, जबकि उन redacted मानों को सुरक्षित रखते हैं जो अब भी सेव किए गए secrets से मैप होते हैं।
• Schema + फ़ॉर्म rendering (config.schema / config.schema.lookup, जिसमें field title / description, मेल खाते UI hints, तत्काल child summaries, nested object/wildcard/array/composition nodes पर docs metadata, साथ ही उपलब्ध होने पर plugin + channel schemas शामिल हैं); Raw JSON editor केवल तब उपलब्ध होता है जब snapshot में सुरक्षित raw round-trip हो।
• यदि कोई snapshot raw text को सुरक्षित रूप से round-trip नहीं कर सकता, तो Control UI उस snapshot के लिए Form mode लागू करता है और Raw mode अक्षम करता है।
• Raw JSON editor "सेव किए गए पर रीसेट करें" flattened snapshot को फिर से render करने के बजाय raw-authored shape (formatting, comments, $include layout) को सुरक्षित रखता है, इसलिए जब snapshot सुरक्षित रूप से round-trip कर सकता है तो बाहरी संपादन reset के बाद भी बने रहते हैं।
• Structured SecretRef object values को form text inputs में read-only render किया जाता है ताकि आकस्मिक object-to-string corruption रोका जा सके।

• Debug: status/health/models snapshots + event log + manual RPC calls (status, health, models.list)।
• event log में Control UI refresh/RPC timings, slow chat/config render timings, और जब browser उन PerformanceObserver entry types को expose करता है तब long animation frames या long tasks के लिए browser responsiveness entries शामिल होती हैं।
• Logs: filter/export के साथ Gateway file logs की live tail (logs.tail)।
• Update: restart report के साथ package/git update + restart (update.run) चलाएं, फिर reconnect के बाद update.status poll करके running Gateway version सत्यापित करें।

• isolated jobs के लिए, delivery का default announce summary होता है। यदि आप internal-only runs चाहते हैं तो none पर स्विच कर सकते हैं।
• announce चुने जाने पर channel/target fields दिखाई देते हैं।
• Webhook mode delivery.mode = "webhook" का उपयोग करता है, जिसमें delivery.to एक वैध HTTP(S) webhook URL पर set होता है।
• main-session jobs के लिए, webhook और none delivery modes उपलब्ध हैं।
• Advanced edit controls में delete-after-run, clear agent override, cron exact/stagger options, agent model/thinking overrides, और best-effort delivery toggles शामिल हैं।
• Form validation field-level errors के साथ inline है; invalid values save button को ठीक होने तक disable कर देते हैं।
• समर्पित bearer token भेजने के लिए cron.webhookToken set करें; यदि छोड़ा गया हो तो webhook auth header के बिना भेजा जाता है।
• Deprecated fallback: notify: true वाले stored legacy jobs को cron.webhook से explicit per-job webhook या completion delivery में migrate करने के लिए openclaw doctor --fix चलाएं।

• chat.send non-blocking है: यह { runId, status: "started" } के साथ तुरंत ack करता है और response chat events के माध्यम से stream होता है। Trusted Control UI clients local diagnostics के लिए optional ACK timing metadata भी receive कर सकते हैं।
• Chat uploads images के साथ non-video files स्वीकार करते हैं। Images native image path रखती हैं; अन्य files managed media के रूप में store होती हैं और history में attachment links के रूप में दिखाई जाती हैं।
• उसी idempotencyKey के साथ दोबारा भेजने पर running के दौरान { status: "in_flight" }, और completion के बाद { status: "ok" } लौटता है।
• chat.history responses UI safety के लिए size-bounded हैं। जब transcript entries बहुत बड़ी होती हैं, Gateway लंबे text fields को truncate कर सकता है, भारी metadata blocks छोड़ सकता है, और oversized messages को placeholder ([chat.history omitted: message too large]) से बदल सकता है।
• जब कोई visible assistant message chat.history में truncated था, तो side reader जरूरत पड़ने पर sessionKey, जरूरत होने पर active agentId, और transcript messageId द्वारा chat.message.get के माध्यम से पूरा display-normalized transcript entry fetch कर सकता है। यदि Gateway अब भी अधिक नहीं लौटा सकता, तो reader truncated preview को चुपचाप दोहराने के बजाय explicit unavailable state दिखाता है।
• Assistant/generated images managed media references के रूप में persist की जाती हैं और authenticated Gateway media URLs के माध्यम से वापस serve की जाती हैं, इसलिए reloads raw base64 image payloads के chat history response में बने रहने पर निर्भर नहीं करते।
• chat.history render करते समय, Control UI visible assistant text से display-only inline directive tags (उदाहरण के लिए [[reply_to_*]] और [[audio_as_voice]]), plain-text tool-call XML payloads (जिसमें <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls>, और truncated tool-call blocks शामिल हैं), और leaked ASCII/full-width model control tokens हटाता है, और उन assistant entries को छोड़ देता है जिनका पूरा visible text केवल exact silent token NO_REPLY / no_reply या heartbeat acknowledgement token HEARTBEAT_OK है।
• active send और final history refresh के दौरान, यदि chat.history थोड़ी देर के लिए पुराना snapshot लौटाता है तो chat view local optimistic user/assistant messages को visible रखता है; Gateway history के catch up होते ही canonical transcript उन local messages को replace कर देता है।
• Live chat events delivery state हैं, जबकि chat.history durable session transcript से rebuild होता है। tool-final events के बाद Control UI history reload करता है और केवल एक छोटी optimistic tail merge करता है; transcript boundary WebChat में documented है।
• chat.inject session transcript में assistant note append करता है और UI-only updates के लिए chat event broadcast करता है (कोई agent run नहीं, कोई channel delivery नहीं)।
• sidebar recent sessions को New Session action, All Sessions link, और session search button के साथ list करता है जो full session picker खोलता है (selected agent द्वारा scoped, search और pagination के साथ)। agents switch करने पर केवल उस agent से जुड़े sessions दिखते हैं और यदि उसके पास अभी saved dashboard sessions नहीं हैं तो उस agent के main session पर fall back होता है।
• प्रत्येक session-picker row session को rename, pin, या archive कर सकती है। active run और agent का main session archive नहीं किया जा सकता। currently selected session को archive करने पर Chat वापस उस agent के main session पर switch हो जाता है।
• desktop widths पर, chat controls एक compact row में रहते हैं और transcript में नीचे scroll करते समय collapse हो जाते हैं; ऊपर scroll करने, top पर लौटने, या bottom तक पहुंचने पर controls restore हो जाते हैं।
• लगातार duplicate text-only messages count badge के साथ एक bubble के रूप में render होते हैं। Images, attachments, tool output, या canvas previews रखने वाले messages uncollapsed छोड़े जाते हैं।
• chat header model और thinking pickers active session को तुरंत sessions.patch के माध्यम से patch करते हैं; वे persistent session overrides हैं, one-turn-only send options नहीं।
• यदि आप उसी session के लिए model picker change save होते समय message भेजते हैं, तो composer chat.send call करने से पहले उस session patch की प्रतीक्षा करता है ताकि send selected model का उपयोग करे।
• Control UI में /new type करने पर New Chat जैसी ही fresh dashboard session बनती है और switch होती है, सिवाय इसके कि जब session.dmScope: "main" configured हो और current parent agent का main session हो; उस स्थिति में यह main session को in place reset करता है। /reset type करने पर current session के लिए Gateway का explicit in-place reset बना रहता है।
• chat model picker Gateway का configured model view request करता है। यदि agents.defaults.models मौजूद है, तो वह allowlist picker को drive करती है, जिसमें provider/* entries शामिल हैं जो provider-scoped catalogs को dynamic रखती हैं। अन्यथा picker explicit models.providers.*.models entries और usable auth वाले providers दिखाता है। पूरा catalog debug models.list RPC के माध्यम से view: "all" के साथ उपलब्ध रहता है।
• जब fresh Gateway session usage reports में current context tokens शामिल होते हैं, तो chat composer toolbar used percentage के साथ एक छोटा context usage ring दिखाता है; पूरा token detail उसके tooltip में रहता है। high context pressure पर ring warning styling में switch होता है और recommended Compaction levels पर एक compact button दिखाता है जो normal session Compaction path चलाता है। Stale token snapshots तब तक hidden रहते हैं जब तक Gateway फिर से fresh usage report नहीं करता।

Talk mode एक registered realtime voice provider का उपयोग करता है। OpenAI को talk.realtime.provider: "openai" के साथ एक openai API-key auth profile, talk.realtime.providers.openai.apiKey, या OPENAI_API_KEY से configure करें; OpenAI OAuth profiles Realtime voice configure नहीं करते। Google को talk.realtime.provider: "google" के साथ talk.realtime.providers.google.apiKey से configure करें। browser को कभी standard provider API key नहीं मिलती। OpenAI WebRTC के लिए एक ephemeral Realtime client secret receive करता है। Google Live browser WebSocket session के लिए one-use constrained Live API auth token receive करता है, जिसमें instructions और tool declarations Gateway द्वारा token में locked होते हैं। वे providers जो केवल backend realtime bridge expose करते हैं, Gateway relay transport के माध्यम से चलते हैं, इसलिए credentials और vendor sockets server-side रहते हैं जबकि browser audio authenticated Gateway RPCs के माध्यम से चलता है। Realtime session prompt Gateway द्वारा assembled होता है; talk.client.create caller-provided instruction overrides स्वीकार नहीं करता।

चैट कंपोज़र में बातचीत शुरू/बंद बटन के बगल में बातचीत विकल्प बटन शामिल होता है। ये विकल्प अगले बातचीत सत्र पर लागू होते हैं और प्रदाता, ट्रांसपोर्ट, मॉडल, आवाज़, रीजनिंग प्रयास, VAD थ्रेशोल्ड, मौन अवधि, और प्रीफ़िक्स पैडिंग को ओवरराइड कर सकते हैं। जब कोई विकल्प खाली होता है, तो Gateway जहाँ उपलब्ध हो वहाँ कॉन्फ़िगर किए गए डिफ़ॉल्ट या प्रदाता डिफ़ॉल्ट का उपयोग करता है। Gateway रिले चुनने से बैकएंड रिले पथ बाध्य होता है; WebRTC चुनने से सत्र क्लाइंट-स्वामित्व वाला रहता है और यदि प्रदाता ब्राउज़र सत्र नहीं बना सकता, तो चुपचाप रिले पर वापस जाने के बजाय विफल हो जाता है।

चैट कंपोज़र में, बातचीत नियंत्रण माइक्रोफ़ोन डिक्टेशन बटन के बगल वाला तरंगों का बटन है। जब बातचीत शुरू होती है, तो कंपोज़र स्थिति पंक्ति ऑडियो कनेक्ट होने तक Connecting Talk..., फिर Talk live, या रियलटाइम टूल कॉल के talk.client.toolCall के माध्यम से कॉन्फ़िगर किए गए बड़े मॉडल से परामर्श करते समय Asking OpenClaw... दिखाती है।

मेंटेनर लाइव स्मोक: OPENAI_API_KEY=... GEMINI_API_KEY=... node --import tsx scripts/dev/realtime-talk-live-smoke.ts OpenAI बैकएंड WebSocket ब्रिज, OpenAI ब्राउज़र WebRTC SDP एक्सचेंज, Google Live सीमित-टोकन ब्राउज़र WebSocket सेटअप, और नकली माइक्रोफ़ोन मीडिया के साथ Gateway रिले ब्राउज़र अडैप्टर सत्यापित करता है। कमांड केवल प्रदाता स्थिति प्रिंट करता है और रहस्य लॉग नहीं करता।

• Stop पर क्लिक करें (chat.abort कॉल करता है)।
• जब कोई रन सक्रिय हो, सामान्य फ़ॉलो-अप कतार में जाते हैं। कतारबद्ध संदेश पर Steer क्लिक करके उस फ़ॉलो-अप को चल रहे टर्न में इंजेक्ट करें।
• आउट-ऑफ़-बैंड निरस्त करने के लिए /stop टाइप करें (या stop, stop action, stop run, stop openclaw, please stop जैसे स्वतंत्र abort वाक्यांश)।
• chat.abort उस सत्र के सभी सक्रिय रन निरस्त करने के लिए { sessionKey } (बिना runId) का समर्थन करता है।

• जब कोई रन निरस्त होता है, तब भी आंशिक सहायक टेक्स्ट UI में दिखाया जा सकता है।
• buffered आउटपुट मौजूद होने पर Gateway निरस्त किए गए आंशिक सहायक टेक्स्ट को ट्रांसक्रिप्ट इतिहास में स्थायी करता है।
• स्थायी प्रविष्टियों में abort मेटाडेटा शामिल होता है, ताकि ट्रांसक्रिप्ट उपभोक्ता abort partials को सामान्य completion आउटपुट से अलग पहचान सकें।

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

allowInsecureAuth केवल local compatibility toggle है:

• यह localhost Control UI sessions को non-secure HTTP contexts में device identity के बिना आगे बढ़ने देता है।
• यह pairing checks को bypass नहीं करता।
• यह remote (non-localhost) device identity requirements को relax नहीं करता।

• सफल trusted-proxy auth operator Control UI sessions को device identity के बिना admit कर सकता है।
• यह node-role Control UI sessions तक extend नहीं होता।
• Same-host loopback reverse proxies फिर भी trusted-proxy auth satisfy नहीं करते; Trusted proxy auth देखें।

• gatewayUrl load के बाद localStorage में stored होता है और URL से हटा दिया जाता है।
• यदि आप gatewayUrl के माध्यम से पूरा ws:// या wss:// endpoint pass करते हैं, तो gatewayUrl value को URL-encode करें ताकि browser query string को सही ढंग से parse करे।
• जब भी संभव हो, token को URL fragment (#token=...) के माध्यम से pass करना चाहिए। fragments server को नहीं भेजे जाते, जिससे request-log और Referer leakage से बचाव होता है। Legacy ?token= query params compatibility के लिए अभी भी एक बार imported होते हैं, लेकिन केवल fallback के रूप में, और bootstrap के तुरंत बाद strip कर दिए जाते हैं।
• password केवल memory में रखा जाता है।
• जब gatewayUrl set होता है, तो UI config या environment credentials पर fall back नहीं करता। token (या password) स्पष्ट रूप से provide करें। explicit credentials का missing होना error है।
• जब Gateway TLS के पीछे हो (Tailscale Serve, HTTPS proxy, आदि), तो wss:// का उपयोग करें।
• gatewayUrl केवल top-level window में accepted है (embedded नहीं), ताकि clickjacking रोकी जा सके।
• Public non-loopback Control UI deployments को gateway.controlUi.allowedOrigins स्पष्ट रूप से set करना होगा (full origins)। loopback, RFC1918/link-local, .local, .ts.net, या Tailscale CGNAT hosts से private same-origin LAN/Tailnet loads Host-header fallback enable किए बिना accepted हैं।
• Gateway startup effective runtime bind और port से http://localhost:<port> और http://127.0.0.1:<port> जैसे local origins seed कर सकता है, लेकिन remote browser origins को अभी भी explicit entries चाहिए।
• tightly controlled local testing को छोड़कर gateway.controlUi.allowedOrigins: ["*"] का उपयोग न करें। इसका अर्थ है किसी भी browser origin को allow करना, न कि "मैं जिस भी host का उपयोग कर रहा हूं, उससे match करें।"
• gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback=true Host-header origin fallback mode enable करता है, लेकिन यह खतरनाक security mode है।