رابط کاربری کنترل

• Chat با model از طریق Gateway WS (chat.history, chat.send, chat.abort, chat.inject).
• refreshهای تاریخچه Chat یک پنجره اخیر محدود با سقف متن برای هر پیام درخواست می‌کنند تا نشست‌های بزرگ مرورگر را مجبور نکنند پیش از قابل استفاده شدن chat، payload کامل transcript را render کند.
• گفت‌وگوی صوتی از طریق نشست‌های realtime مرورگر. OpenAI از WebRTC مستقیم استفاده می‌کند، Google Live از یک token مرورگر محدود و یک‌بارمصرف روی WebSocket استفاده می‌کند، و Pluginهای صدای realtime فقط backend از transport relay Gateway استفاده می‌کنند. نشست‌های provider که مالک آن‌ها client است با talk.client.create شروع می‌شوند؛ نشست‌های relay Gateway با talk.session.create شروع می‌شوند. relay، credentialهای provider را روی Gateway نگه می‌دارد، در حالی که مرورگر PCM میکروفون را از طریق talk.session.appendAudio stream می‌کند، tool callهای provider‏ openclaw_agent_consult را برای policy Gateway و model بزرگ‌تر پیکربندی‌شده OpenClaw از طریق talk.client.toolCall forward می‌کند، و هدایت صوتی active-run را از طریق talk.client.steer یا talk.session.steer route می‌کند.
• tool callها + کارت‌های خروجی زنده tool را در Chat stream می‌کند (رویدادهای agent).
• تب Activity با خلاصه‌های browser-local و redaction-first از فعالیت زنده tool از تحویل موجود session.tool / رویداد tool.

• کانال‌ها: وضعیت کانال‌های داخلی به‌همراه Pluginهای bundled/external، ورود با QR، و پیکربندی برای هر کانال (channels.status, web.login.*, config.patch).
• refreshهای probe کانال snapshot قبلی را تا پایان بررسی‌های کند provider قابل مشاهده نگه می‌دارند، و وقتی probe یا audit از بودجه UI خود عبور کند، snapshotهای جزئی برچسب‌گذاری می‌شوند.
• instanceها: فهرست presence + refresh (system-presence).
• نشست‌ها: به‌طور پیش‌فرض نشست‌های agent پیکربندی‌شده را فهرست می‌کند، نشست‌های پرتکرار را pin می‌کند، نامشان را تغییر می‌دهد، نشست‌های غیرفعال را archive یا restore می‌کند، از کلیدهای نشست agent پیکربندی‌نشده stale fallback می‌کند، و overrideهای model/thinking/fast/verbose/trace/reasoning را برای هر نشست اعمال می‌کند (sessions.list, sessions.patch). نشست‌های pin‌شده بالاتر از نشست‌های اخیر pin‌نشده sort می‌شوند؛ نشست‌های archive‌شده در نمای archived صفحه Sessions زندگی می‌کنند و transcriptهای خود را نگه می‌دارند.
• رویاها: وضعیت Dreaming، toggle فعال/غیرفعال، و خواننده Dream Diary (doctor.memory.status, doctor.memory.dreamDiary, config.patch).

• jobهای Cron: فهرست/افزودن/ویرایش/اجرا/فعال‌سازی/غیرفعال‌سازی + تاریخچه اجرا (cron.*).
• Skills: وضعیت، فعال‌سازی/غیرفعال‌سازی، نصب، به‌روزرسانی‌های API key (skills.*).
• nodeها: فهرست + caps (node.list)، ساخت کدهای setup موبایل، و تأیید جفت‌سازی دستگاه (device.pair.*).
• تأییدهای exec: ویرایش allowlistهای gateway یا node + policy پرسش برای exec host=gateway/node (exec.approvals.*).

• مشاهده/ویرایش ~/.openclaw/openclaw.json (config.get, config.set).
• MCP یک صفحه تنظیمات اختصاصی برای سرورهای پیکربندی‌شده، فعال‌سازی، خلاصه‌های OAuth/فیلتر/موازی، فرمان‌های رایج اپراتور، و ویرایشگر پیکربندی محدوده‌دار mcp دارد.
• اعمال + راه‌اندازی مجدد با اعتبارسنجی (config.apply) و بیدار کردن آخرین نشست فعال.
• نوشتن‌ها شامل یک محافظ base-hash هستند تا از بازنویسی و از بین بردن ویرایش‌های هم‌زمان جلوگیری شود.
• نوشتن‌ها (config.set/config.apply/config.patch) پیش از اجرا، رفع SecretRef فعال را برای refs موجود در payload پیکربندی ارسال‌شده بررسی می‌کنند؛ refs فعال و حل‌نشده ارسال‌شده پیش از نوشتن رد می‌شوند.
• ذخیره‌های فرم، جایگزین‌های ویرایش‌شده و قدیمی را که از پیکربندی ذخیره‌شده قابل بازیابی نیستند دور می‌ریزند، در حالی که مقادیر ویرایش‌شده‌ای را که همچنان به اسرار ذخیره‌شده نگاشت می‌شوند حفظ می‌کنند.
• رندر schema + فرم (config.schema / config.schema.lookup، شامل فیلد title / description، راهنمایی‌های UI منطبق، خلاصه‌های فرزند مستقیم، فراداده مستندات روی گره‌های تو در توی object/wildcard/array/composition، به‌علاوه schemaهای Plugin + کانال در صورت موجود بودن)؛ ویرایشگر Raw JSON فقط زمانی در دسترس است که snapshot یک رفت‌وبرگشت خام امن داشته باشد.
• اگر یک snapshot نتواند متن خام را با ایمنی رفت‌وبرگشت کند، رابط کاربری کنترل حالت Form را اجباری می‌کند و حالت Raw را برای آن snapshot غیرفعال می‌کند.
• گزینه "Reset to saved" در ویرایشگر Raw JSON شکل نوشته‌شده خام را (قالب‌بندی، کامنت‌ها، چیدمان $include) به‌جای رندر دوباره یک snapshot تخت‌شده حفظ می‌کند، بنابراین وقتی snapshot بتواند با ایمنی رفت‌وبرگشت کند، ویرایش‌های خارجی پس از reset باقی می‌مانند.
• مقادیر object ساختاریافته SecretRef در ورودی‌های متنی فرم به‌صورت فقط‌خواندنی رندر می‌شوند تا از خراب شدن تصادفی object به string جلوگیری شود.

• اشکال‌زدایی: snapshotهای status/health/models + لاگ رویداد + فراخوانی‌های RPC دستی (status, health, models.list).
• لاگ رویداد شامل زمان‌بندی‌های refresh/RPC رابط کاربری کنترل، زمان‌بندی‌های کند رندر chat/config، و ورودی‌های پاسخ‌گویی مرورگر برای فریم‌های انیمیشن طولانی یا taskهای طولانی است، زمانی که مرورگر آن نوع ورودی‌های PerformanceObserver را ارائه کند.
• لاگ‌ها: tail زنده لاگ‌های فایل gateway با فیلتر/خروجی‌گیری (logs.tail).
• به‌روزرسانی: اجرای به‌روزرسانی package/git + راه‌اندازی مجدد (update.run) همراه با گزارش راه‌اندازی مجدد، سپس polling روی update.status پس از اتصال مجدد برای تأیید نسخه Gateway در حال اجرا.

• برای کارهای ایزوله، delivery به‌طور پیش‌فرض روی اعلام خلاصه است. اگر اجراهای فقط داخلی می‌خواهید، می‌توانید آن را به none تغییر دهید.
• وقتی announce انتخاب شده باشد، فیلدهای channel/target ظاهر می‌شوند.
• حالت Webhook از delivery.mode = "webhook" با delivery.to تنظیم‌شده روی یک URL معتبر HTTP(S) webhook استفاده می‌کند.
• برای کارهای نشست اصلی، حالت‌های delivery با webhook و none در دسترس هستند.
• کنترل‌های ویرایش پیشرفته شامل delete-after-run، پاک‌سازی agent override، گزینه‌های cron exact/stagger، overrideهای agent model/thinking، و toggleهای delivery با بهترین تلاش هستند.
• اعتبارسنجی فرم به‌صورت inline با خطاهای سطح فیلد انجام می‌شود؛ مقادیر نامعتبر تا زمان اصلاح، دکمه ذخیره را غیرفعال می‌کنند.
• cron.webhookToken را تنظیم کنید تا یک bearer token اختصاصی ارسال شود؛ اگر حذف شود، webhook بدون header احراز هویت ارسال می‌شود.
• fallback منسوخ: openclaw doctor --fix را اجرا کنید تا کارهای legacy ذخیره‌شده با notify: true از cron.webhook به webhook صریح برای هر کار یا completion delivery منتقل شوند.

• chat.send غیرمسدودکننده است: بلافاصله با { runId, status: "started" } ack می‌دهد و پاسخ از طریق رویدادهای chat stream می‌شود. کلاینت‌های مورد اعتماد رابط کاربری کنترل همچنین ممکن است فراداده اختیاری زمان‌بندی ACK را برای diagnostics محلی دریافت کنند.
• آپلودهای Chat تصویرها به‌علاوه فایل‌های غیر ویدیویی را می‌پذیرند. تصویرها مسیر native image را نگه می‌دارند؛ فایل‌های دیگر به‌عنوان managed media ذخیره می‌شوند و در history به‌صورت لینک‌های attachment نشان داده می‌شوند.
• ارسال دوباره با همان idempotencyKey هنگام اجرا { status: "in_flight" } و پس از تکمیل { status: "ok" } برمی‌گرداند.
• پاسخ‌های chat.history برای ایمنی UI از نظر اندازه محدود هستند. وقتی ورودی‌های transcript بیش از حد بزرگ باشند، Gateway ممکن است فیلدهای متنی طولانی را کوتاه کند، بلوک‌های metadata سنگین را حذف کند، و پیام‌های بیش‌ازحد بزرگ را با یک placeholder ([chat.history omitted: message too large]) جایگزین کند.
• وقتی یک پیام قابل مشاهده assistant در chat.history کوتاه شده باشد، خواننده کناری می‌تواند ورودی transcript کامل و display-normalized را در صورت نیاز از طریق chat.message.get با sessionKey، agentId فعال در صورت نیاز، و transcript messageId دریافت کند. اگر Gateway همچنان نتواند مقدار بیشتری برگرداند، خواننده به‌جای تکرار بی‌صدای پیش‌نمایش کوتاه‌شده، یک وضعیت unavailable صریح نشان می‌دهد.
• تصاویر assistant/generated به‌عنوان managed media references پایدار می‌شوند و از طریق URLهای رسانه احراز هویت‌شده Gateway برگردانده می‌شوند، بنابراین reloadها به باقی ماندن payloadهای تصویر base64 خام در پاسخ chat history وابسته نیستند.
• هنگام رندر chat.history، رابط کاربری کنترل tagهای directive درون‌خطی فقط نمایشی را از متن قابل مشاهده assistant حذف می‌کند (برای مثال [[reply_to_*]] و [[audio_as_voice]])، payloadهای XML فراخوانی tool به‌صورت متن ساده (شامل <tool_call>...</tool_call>، <function_call>...</function_call>، <tool_calls>...</tool_calls>، <function_calls>...</function_calls>، و بلوک‌های فراخوانی tool کوتاه‌شده)، و tokenهای کنترلی مدل ASCII/full-width نشت‌کرده را حذف می‌کند، و ورودی‌های assistant را که کل متن قابل مشاهده‌شان فقط token خاموش دقیق NO_REPLY / no_reply یا token تأیید Heartbeat یعنی HEARTBEAT_OK است کنار می‌گذارد.
• در طول یک ارسال فعال و refresh نهایی history، نمای chat پیام‌های optimistic محلی user/assistant را قابل مشاهده نگه می‌دارد اگر chat.history به‌طور کوتاه یک snapshot قدیمی‌تر برگرداند؛ transcript canonical پس از اینکه history در Gateway به‌روز شد، آن پیام‌های محلی را جایگزین می‌کند.
• رویدادهای زنده chat وضعیت delivery هستند، در حالی که chat.history از transcript پایدار نشست دوباره ساخته می‌شود. پس از رویدادهای tool-final، رابط کاربری کنترل history را reload می‌کند و فقط یک tail کوچک optimistic را merge می‌کند؛ مرز transcript در WebChat مستند شده است.
• chat.inject یک یادداشت assistant را به transcript نشست append می‌کند و یک رویداد chat را برای به‌روزرسانی‌های فقط UI broadcast می‌کند (بدون agent run، بدون channel delivery).
• نوار کناری نشست‌های اخیر را با یک اقدام New Session، یک لینک All Sessions، و یک دکمه جست‌وجوی نشست فهرست می‌کند که picker کامل نشست را باز می‌کند (محدوده‌دار به agent انتخاب‌شده، با search و pagination). تغییر agentها فقط نشست‌های وابسته به آن agent را نشان می‌دهد و وقتی هنوز dashboard session ذخیره‌شده‌ای ندارد به main session همان agent fallback می‌کند.
• هر ردیف session-picker می‌تواند نشست را rename، pin، یا archive کند. یک run فعال و main session یک agent نمی‌توانند archive شوند. Archive کردن نشست انتخاب‌شده فعلی، Chat را به main session آن agent برمی‌گرداند.
• در عرض‌های دسکتاپ، کنترل‌های chat روی یک ردیف فشرده می‌مانند و هنگام scroll به پایین transcript جمع می‌شوند؛ scroll به بالا، بازگشت به top، یا رسیدن به bottom کنترل‌ها را بازمی‌گرداند.
• پیام‌های متوالی و تکراری فقط متنی به‌صورت یک bubble با نشان شمارش رندر می‌شوند. پیام‌هایی که تصویر، attachment، خروجی tool، یا پیش‌نمایش canvas دارند، جمع نمی‌شوند.
• pickerهای model و thinking در header چت، نشست فعال را بلافاصله از طریق sessions.patch patch می‌کنند؛ آن‌ها overrideهای پایدار نشست هستند، نه گزینه‌های ارسال فقط برای یک نوبت.
• اگر در حالی پیام بفرستید که تغییر model picker برای همان نشست هنوز در حال ذخیره شدن است، composer پیش از فراخوانی chat.send منتظر patch آن نشست می‌ماند تا ارسال از model انتخاب‌شده استفاده کند.
• تایپ /new در رابط کاربری کنترل همان dashboard session تازه New Chat را ایجاد کرده و به آن switch می‌کند، مگر زمانی که session.dmScope: "main" پیکربندی شده باشد و parent فعلی main session آن agent باشد؛ در آن حالت main session را در همان‌جا reset می‌کند. تایپ /reset reset صریح درجا برای نشست فعلی در Gateway را حفظ می‌کند.
• model picker چت، نمای model پیکربندی‌شده Gateway را درخواست می‌کند. اگر agents.defaults.models وجود داشته باشد، آن allowlist picker را هدایت می‌کند، از جمله ورودی‌های provider/* که catalogهای محدوده‌دار به provider را dynamic نگه می‌دارند. در غیر این صورت picker ورودی‌های صریح models.providers.*.models به‌علاوه providerهایی با auth قابل استفاده را نشان می‌دهد. catalog کامل از طریق RPC اشکال‌زدایی models.list با view: "all" در دسترس می‌ماند.
• وقتی گزارش‌های تازه استفاده از نشست Gateway شامل tokenهای context فعلی باشند، toolbar composer چت یک حلقه کوچک استفاده از context را با درصد استفاده‌شده نشان می‌دهد؛ جزئیات کامل token در tooltip آن قرار دارد. حلقه در فشار بالای context به styling هشدار تغییر می‌کند و، در سطح‌های پیشنهادی Compaction، یک دکمه فشرده نشان می‌دهد که مسیر عادی Compaction نشست را اجرا می‌کند. snapshotهای token قدیمی تا زمانی که Gateway دوباره استفاده تازه را گزارش کند پنهان می‌شوند.

حالت Talk از یک ارائه‌دهنده voice realtime ثبت‌شده استفاده می‌کند. OpenAI را با talk.realtime.provider: "openai" به‌علاوه یک پروفایل auth با API key برای openai، talk.realtime.providers.openai.apiKey، یا OPENAI_API_KEY پیکربندی کنید؛ پروفایل‌های OAuth مربوط به OpenAI، voice Realtime را پیکربندی نمی‌کنند. Google را با talk.realtime.provider: "google" به‌علاوه talk.realtime.providers.google.apiKey پیکربندی کنید. مرورگر هرگز یک API key استاندارد provider را دریافت نمی‌کند. OpenAI یک secret موقتی Realtime client برای WebRTC دریافت می‌کند. Google Live یک auth token محدودشده و یک‌بارمصرف Live API برای نشست WebSocket مرورگر دریافت می‌کند، همراه با instructionها و declarationهای tool که توسط Gateway داخل token قفل شده‌اند. Providerهایی که فقط یک backend realtime bridge ارائه می‌کنند از طریق relay transport در Gateway اجرا می‌شوند، بنابراین credentialها و socketهای vendor در سمت سرور می‌مانند در حالی که صدای مرورگر از طریق RPCهای احراز هویت‌شده Gateway جابه‌جا می‌شود. prompt نشست Realtime توسط Gateway مونتاژ می‌شود؛ talk.client.create overrideهای instruction ارائه‌شده توسط caller را نمی‌پذیرد.

سازندهٔ Chat یک دکمهٔ گزینه‌های گفت‌وگو کنار دکمهٔ شروع/توقف گفت‌وگو دارد. این گزینه‌ها روی نشست گفت‌وگوی بعدی اعمال می‌شوند و می‌توانند provider، transport، model، voice، reasoning effort، آستانهٔ VAD، مدت سکوت، و prefix padding را بازنویسی کنند. وقتی گزینه‌ای خالی باشد، Gateway در صورت وجود از پیش‌فرض‌های پیکربندی‌شده یا از پیش‌فرض provider استفاده می‌کند. انتخاب رلهٔ Gateway مسیر رلهٔ backend را اجباری می‌کند؛ انتخاب WebRTC نشست را تحت مالکیت client نگه می‌دارد و اگر provider نتواند یک نشست مرورگر بسازد، به‌جای بازگشت بی‌صدا به رله، شکست می‌خورد.

در سازندهٔ Chat، کنترل گفت‌وگو همان دکمهٔ موج‌ها کنار دکمهٔ دیکتهٔ میکروفون است. وقتی گفت‌وگو شروع می‌شود، ردیف وضعیت سازنده ابتدا Connecting Talk... را نشان می‌دهد، سپس وقتی صدا وصل است Talk live را، یا وقتی یک فراخوانی ابزار realtime از طریق talk.client.toolCall در حال مشورت با مدل بزرگ‌تر پیکربندی‌شده است، Asking OpenClaw... را نشان می‌دهد.

دودآزمایی زندهٔ maintainer: OPENAI_API_KEY=... GEMINI_API_KEY=... node --import tsx scripts/dev/realtime-talk-live-smoke.ts پل WebSocket backend OpenAI، تبادل SDP مرورگر WebRTC OpenAI، راه‌اندازی WebSocket مرورگر Google Live با توکن محدود، و آداپتر مرورگر رلهٔ Gateway با رسانهٔ میکروفون ساختگی را تأیید می‌کند. این فرمان فقط وضعیت provider را چاپ می‌کند و secrets را ثبت نمی‌کند.

• روی توقف کلیک کنید (chat.abort را فراخوانی می‌کند).
• وقتی یک run فعال است، follow-upهای عادی در صف قرار می‌گیرند. روی هدایت در یک پیام صف‌شده کلیک کنید تا آن follow-up را به نوبت در حال اجرا تزریق کنید.
• برای لغو خارج از باند، /stop را تایپ کنید (یا عبارت‌های مستقل لغو مانند stop، stop action، stop run، stop openclaw، please stop).
• chat.abort از { sessionKey } (بدون runId) برای لغو همهٔ runهای فعال آن نشست پشتیبانی می‌کند.

• وقتی یک run لغو می‌شود، متن جزئی assistant همچنان می‌تواند در UI نمایش داده شود.
• Gateway متن جزئی لغوشدهٔ assistant را وقتی خروجی بافرشده وجود دارد، در تاریخچهٔ transcript پایدار می‌کند.
• ورودی‌های پایدارشده شامل metadata لغو هستند تا مصرف‌کنندگان transcript بتوانند partialهای لغو را از خروجی تکمیل عادی تشخیص دهند.

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

allowInsecureAuth فقط یک toggle سازگاری محلی است:

• به نشست‌های Control UI در localhost اجازه می‌دهد بدون هویت دستگاه در contextهای HTTP غیرامن ادامه پیدا کنند.
• بررسی‌های جفت‌سازی را bypass نمی‌کند.
• نیازمندی‌های هویت دستگاه remote (غیر-localhost) را کاهش نمی‌دهد.

• احراز هویت موفق trusted-proxy می‌تواند نشست‌های Control UI مربوط به operator را بدون هویت دستگاه بپذیرد.
• این مورد به نشست‌های Control UI با نقش node تعمیم پیدا نمی‌کند.
• reverse proxyهای loopback روی همان میزبان همچنان احراز هویت trusted-proxy را برآورده نمی‌کنند؛ احراز هویت trusted proxy را ببینید.

• gatewayUrl پس از بارگذاری در localStorage ذخیره و از URL حذف می‌شود.
• اگر یک نقطه پایانی کامل ws:// یا wss:// را از طریق gatewayUrl می‌فرستید، مقدار gatewayUrl را URL-encode کنید تا مرورگر رشته پرس‌وجو را درست تجزیه کند.
• token تا حد امکان باید از طریق قطعه URL (#token=...) ارسال شود. قطعه‌ها به سرور ارسال نمی‌شوند، که از نشت در لاگ درخواست و Referer جلوگیری می‌کند. پارامترهای پرس‌وجوی قدیمی ?token= هنوز برای سازگاری یک بار وارد می‌شوند، اما فقط به‌عنوان مسیر جایگزین، و بلافاصله پس از bootstrap حذف می‌شوند.
• password فقط در حافظه نگه داشته می‌شود.
• وقتی gatewayUrl تنظیم شده باشد، رابط کاربری به اعتبارنامه‌های config یا محیط برنمی‌گردد. token (یا password) را صریح ارائه کنید. نبود اعتبارنامه‌های صریح خطا است.
• وقتی Gateway پشت TLS است (Tailscale Serve، پراکسی HTTPS و غیره)، از wss:// استفاده کنید.
• gatewayUrl فقط در یک پنجره سطح بالا پذیرفته می‌شود (نه جاسازی‌شده) تا از clickjacking جلوگیری شود.
• استقرارهای عمومی غیر local loopback مربوط به Control UI باید gateway.controlUi.allowedOrigins را صریح تنظیم کنند (مبدأهای کامل). بارگذاری‌های خصوصی LAN/Tailnet هم‌مبدأ از local loopback، RFC1918/link-local، .local، .ts.net، یا میزبان‌های CGNAT متعلق به Tailscale بدون فعال کردن مسیر جایگزین Host-header پذیرفته می‌شوند.
• راه‌اندازی Gateway ممکن است مبدأهای محلی مانند http://localhost:<port> و http://127.0.0.1:<port> را از bind و پورت مؤثر زمان اجرا seed کند، اما مبدأهای مرورگر راه دور همچنان به ورودی‌های صریح نیاز دارند.
• از gateway.controlUi.allowedOrigins: ["*"] استفاده نکنید مگر برای آزمایش محلی کاملاً کنترل‌شده. معنای آن اجازه دادن به هر مبدأ مرورگر است، نه «با هر میزبانی که استفاده می‌کنم تطبیق بده».
• gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback=true حالت مسیر جایگزین مبدأ Host-header را فعال می‌کند، اما این یک حالت امنیتی خطرناک است.