واجهة التحكم

• الدردشة مع النموذج عبر Gateway WS (chat.history, chat.send, chat.abort, chat.inject).
• تطلب تحديثات سجل الدردشة نافذة حديثة محدودة مع حدود نصية لكل رسالة حتى لا تُجبر الجلسات الكبيرة المتصفح على عرض حمولة نص كاملة قبل أن تصبح الدردشة قابلة للاستخدام.
• التحدث عبر جلسات المتصفح الفورية. يستخدم OpenAI WebRTC مباشراً، ويستخدم Google Live رمز متصفح مقيّداً لمرة واحدة عبر WebSocket، وتستخدم Plugins الصوت الفورية المخصصة للخلفية فقط نقل الترحيل عبر Gateway. تبدأ جلسات المزود التي يملكها العميل بـ talk.client.create؛ وتبدأ جلسات ترحيل Gateway بـ talk.session.create. يحتفظ الترحيل باعتمادات المزود على Gateway بينما يبث المتصفح PCM الميكروفون عبر talk.session.appendAudio، ويمرر استدعاءات أدوات المزود openclaw_agent_consult عبر talk.client.toolCall من أجل سياسة Gateway ونموذج OpenClaw الأكبر المكوّن، ويوجه توجيه الصوت للتشغيل النشط عبر talk.client.steer أو talk.session.steer.
• بث استدعاءات الأدوات + بطاقات مخرجات الأدوات الحية في الدردشة (أحداث الوكيل).
• علامة تبويب النشاط مع ملخصات محلية في المتصفح، تبدأ بالتنقيح، لنشاط الأدوات الحي من تسليم أحداث session.tool / الأداة الحالي.

• القنوات: حالة القنوات المدمجة وقنوات Plugins المرفقة/الخارجية، وتسجيل الدخول عبر QR، وتكوين لكل قناة (channels.status, web.login.*, config.patch).
• تحافظ تحديثات فحص القنوات على اللقطة السابقة مرئية بينما تنتهي فحوصات المزود البطيئة، وتُوسم اللقطات الجزئية عندما يتجاوز فحص أو تدقيق ميزانية واجهة المستخدم الخاصة به.
• المثيلات: قائمة الحضور + تحديث (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 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، وتلميحات واجهة المستخدم المطابقة، وملخصات الأبناء المباشرة، وبيانات تعريف التوثيق على عقد الكائنات المتداخلة/أحرف البدل/المصفوفات/التركيب، إضافة إلى مخططات Plugin + القنوات عند توفرها)؛ لا يتوفر محرر JSON الخام إلا عندما تكون اللقطة قادرة على جولة ذهاب وعودة خام آمنة.
• إذا تعذّر على لقطة إجراء جولة ذهاب وعودة آمنة للنص الخام، تفرض واجهة التحكم وضع النموذج وتعطل الوضع الخام لتلك اللقطة.
• يحافظ أمر "إعادة الضبط إلى المحفوظ" في محرر JSON الخام على الشكل المؤلف خامًا (التنسيق، التعليقات، وتخطيط $include) بدلًا من إعادة عرض لقطة مسطحة، لذلك تبقى التعديلات الخارجية بعد إعادة الضبط عندما تستطيع اللقطة إجراء جولة ذهاب وعودة آمنة.
• تُعرض قيم كائن SecretRef المنظمة للقراءة فقط في حقول إدخال النص في النموذج لمنع التلف العرضي من كائن إلى سلسلة نصية.

• التصحيح: لقطات الحالة/السلامة/النماذج + سجل الأحداث + استدعاءات RPC يدوية (status، health، models.list).
• يتضمن سجل الأحداث توقيتات تحديث واجهة التحكم/RPC، وتوقيتات عرض الدردشة/الإعدادات البطيئة، وإدخالات استجابة المتصفح لإطارات الرسوم المتحركة الطويلة أو المهام الطويلة عندما يكشف المتصفح أنواع إدخال PerformanceObserver تلك.
• السجلات: متابعة حية لسجلات ملفات Gateway مع التصفية/التصدير (logs.tail).
• التحديث: تشغيل تحديث حزمة/git + إعادة التشغيل (update.run) مع تقرير إعادة تشغيل، ثم استطلاع update.status بعد إعادة الاتصال للتحقق من إصدار Gateway قيد التشغيل.

• للمهام المعزولة، يكون التسليم افتراضيًا على إعلان الملخص. يمكنك التبديل إلى لا شيء إذا أردت تشغيلات داخلية فقط.
• تظهر حقول القناة/الهدف عند تحديد الإعلان.
• يستخدم وضع Webhook القيمة delivery.mode = "webhook" مع ضبط delivery.to على عنوان URL صالح لـ webhook عبر HTTP(S).
• لمهام الجلسة الرئيسية، تتوفر أوضاع تسليم webhook ولا شيء.
• تتضمن عناصر التحكم المتقدمة للتحرير الحذف بعد التشغيل، ومسح تجاوز الوكيل، وخيارات cron الدقيقة/المتدرجة، وتجاوزات نموذج/تفكير الوكيل، ومفاتيح تسليم بأفضل جهد.
• يكون تحقق النموذج مضمّنًا مع أخطاء على مستوى الحقول؛ وتعطل القيم غير الصالحة زر الحفظ حتى تُصلح.
• اضبط cron.webhookToken لإرسال رمز حامل مخصص؛ إذا حُذف، يُرسل webhook دون ترويسة مصادقة.
• بديل مهمل: شغّل openclaw doctor --fix لترحيل المهام القديمة المخزنة ذات notify: true من cron.webhook إلى webhook صريح لكل مهمة أو تسليم اكتمال.

• chat.send غير حاجب: يقر فورًا بـ { runId, status: "started" } وتتدفق الاستجابة عبر أحداث chat. قد يتلقى عملاء واجهة التحكم الموثوقون أيضًا بيانات تعريف اختيارية لتوقيت الإقرار للتشخيصات المحلية.
• تقبل عمليات رفع الدردشة الصور إضافة إلى الملفات غير الفيديو. تحتفظ الصور بمسار الصورة الأصلي؛ وتُخزن الملفات الأخرى كوسائط مُدارة وتظهر في السجل كروابط مرفقات.
• تعيد إعادة الإرسال باستخدام idempotencyKey نفسه { status: "in_flight" } أثناء التشغيل، و{ status: "ok" } بعد الاكتمال.
• تكون استجابات chat.history محدودة الحجم لسلامة واجهة المستخدم. عندما تكون إدخالات النص كبيرة جدًا، قد يقتطع Gateway حقول النص الطويلة، ويحذف كتل بيانات التعريف الثقيلة، ويستبدل الرسائل المفرطة الحجم بعنصر نائب ([chat.history omitted: message too large]).
• عندما تُقتطع رسالة مساعد مرئية في chat.history، يستطيع القارئ الجانبي جلب إدخال النص الكامل بعد تطبيع العرض عند الطلب عبر chat.message.get باستخدام sessionKey، وagentId النشط عند الحاجة، وmessageId الخاص بالنص. إذا كان Gateway لا يزال عاجزًا عن إرجاع المزيد، يعرض القارئ حالة عدم توفر صريحة بدلًا من تكرار المعاينة المقتطعة بصمت.
• تُحفظ الصور المساعدة/المولدة كمراجع وسائط مُدارة وتُقدّم مرة أخرى عبر عناوين URL مصادق عليها لوسائط Gateway، بحيث لا تعتمد عمليات إعادة التحميل على بقاء حمولات صور base64 الخام في استجابة سجل الدردشة.
• عند عرض chat.history، تزيل واجهة التحكم وسوم التعليمات المضمنة المخصصة للعرض فقط من نص المساعد المرئي (مثل [[reply_to_*]] و[[audio_as_voice]])، وحمولات XML لاستدعاءات الأدوات كنص عادي (بما في ذلك <tool_call>...</tool_call>، و<function_call>...</function_call>، و<tool_calls>...</tool_calls>، و<function_calls>...</function_calls>، وكتل استدعاءات الأدوات المقتطعة)، ورموز تحكم النموذج المسرّبة بصيغة ASCII/العرض الكامل، وتحذف إدخالات المساعد التي يكون نصها المرئي كله هو الرمز الصامت الدقيق NO_REPLY / no_reply أو رمز إقرار Heartbeat HEARTBEAT_OK.
• أثناء إرسال نشط وتحديث السجل النهائي، يحافظ عرض الدردشة على رسائل المستخدم/المساعد المحلية التفاؤلية مرئية إذا أعاد chat.history لفترة وجيزة لقطة أقدم؛ ويستبدل النص الأساسي تلك الرسائل المحلية بمجرد أن يلحق سجل Gateway.
• أحداث chat الحية هي حالة التسليم، بينما يُعاد بناء chat.history من نص الجلسة الدائم. بعد أحداث نهاية الأدوات، تعيد واجهة التحكم تحميل السجل وتدمج ذيلًا تفاؤليًا صغيرًا فقط؛ وموثق حد النص في WebChat.
• يضيف chat.inject ملاحظة مساعد إلى نص الجلسة ويبث حدث chat لتحديثات واجهة المستخدم فقط (دون تشغيل وكيل، ودون تسليم قناة).
• يسرد الشريط الجانبي الجلسات الأخيرة مع إجراء جلسة جديدة، ورابط كل الجلسات، وزر بحث جلسات يفتح منتقي الجلسات الكامل (محدد النطاق بحسب الوكيل المحدد، مع البحث والترقيم الصفحي). يعرض تبديل الوكلاء الجلسات المرتبطة بذلك الوكيل فقط، ويعود إلى الجلسة الرئيسية لذلك الوكيل عندما لا تكون لديه جلسات لوحة محفوظة بعد.
• يمكن لكل صف في منتقي الجلسات إعادة تسمية الجلسة أو تثبيتها أو أرشفتها. لا يمكن أرشفة تشغيل نشط ولا الجلسة الرئيسية لوكيل. تؤدي أرشفة الجلسة المحددة حاليًا إلى إعادة الدردشة إلى الجلسة الرئيسية لذلك الوكيل.
• على عروض سطح المكتب، تبقى عناصر التحكم بالدردشة في صف مضغوط واحد وتنهار أثناء التمرير لأسفل في النص؛ ويؤدي التمرير لأعلى، أو الرجوع إلى الأعلى، أو الوصول إلى الأسفل إلى استعادة عناصر التحكم.
• تُعرض الرسائل النصية المتتالية المكررة فقط كفقاعة واحدة مع شارة عدد. تُترك الرسائل التي تحمل صورًا أو مرفقات أو إخراج أدوات أو معاينات لوحة دون طي.
• يحدّث منتقيا النموذج والتفكير في رأس الدردشة الجلسة النشطة فورًا عبر sessions.patch؛ وهما تجاوزات جلسة دائمة، وليسا خيارات إرسال لدورة واحدة فقط.
• إذا أرسلت رسالة بينما لا يزال تغيير منتقي النموذج للجلسة نفسها قيد الحفظ، ينتظر المؤلف تصحيح تلك الجلسة قبل استدعاء chat.send كي يستخدم الإرسال النموذج المحدد.
• تؤدي كتابة /new في واجهة التحكم إلى إنشاء نفس جلسة لوحة التحكم الجديدة مثل دردشة جديدة والتبديل إليها، إلا عندما يكون session.dmScope: "main" مهيأً ويكون الأصل الحالي هو الجلسة الرئيسية للوكيل؛ في تلك الحالة تعيد ضبط الجلسة الرئيسية في مكانها. تحافظ كتابة /reset على إعادة الضبط الصريحة في المكان الحالي من Gateway للجلسة الحالية.
• يطلب منتقي نموذج الدردشة عرض النموذج المهيأ في Gateway. إذا كان agents.defaults.models موجودًا، فتلك القائمة المسموح بها تقود المنتقي، بما في ذلك إدخالات provider/* التي تبقي الفهارس المحددة بالنطاق حسب المزود ديناميكية. بخلاف ذلك يعرض المنتقي إدخالات models.providers.*.models الصريحة إضافة إلى المزودين ذوي المصادقة القابلة للاستخدام. يبقى الفهرس الكامل متاحًا عبر RPC التصحيح models.list مع view: "all".
• عندما تتضمن تقارير استخدام جلسة Gateway الحديثة رموز السياق الحالية، يعرض شريط أدوات مؤلف الدردشة حلقة استخدام سياق صغيرة مع النسبة المئوية المستخدمة؛ وتوجد تفاصيل الرموز الكاملة في تلميحها. تتحول الحلقة إلى تنسيق تحذيري عند ضغط سياق عالٍ، وعند مستويات Compaction الموصى بها، تعرض زرًا مضغوطًا يشغل مسار Compaction العادي للجلسة. تُخفى لقطات الرموز القديمة حتى يبلغ Gateway عن استخدام حديث مرة أخرى.

يستخدم وضع التحدث مزود صوت مسجلًا للوقت الفعلي. هيّئ OpenAI باستخدام talk.realtime.provider: "openai" إضافة إلى ملف تعريف مصادقة openai بمفتاح API، أو talk.realtime.providers.openai.apiKey، أو OPENAI_API_KEY؛ لا تهيئ ملفات تعريف OAuth الخاصة بـ OpenAI صوت الوقت الفعلي. هيّئ Google باستخدام talk.realtime.provider: "google" إضافة إلى talk.realtime.providers.google.apiKey. لا يتلقى المتصفح أبدًا مفتاح API قياسيًا للمزود. يتلقى OpenAI سر عميل وقت فعلي مؤقتًا لـ WebRTC. يتلقى Google Live رمز مصادقة Live API مقيدًا لمرة واحدة لجلسة WebSocket في المتصفح، مع تعليمات وتصريحات أدوات مقفلة داخل الرمز بواسطة Gateway. يعمل المزودون الذين لا يكشفون إلا جسر وقت فعلي خلفيًا عبر نقل ترحيل Gateway، لذلك تبقى بيانات الاعتماد ومقابس البائع من جانب الخادم بينما ينتقل صوت المتصفح عبر RPCs مصادق عليها من Gateway. يُجمع موجه جلسة الوقت الفعلي بواسطة Gateway؛ ولا يقبل talk.client.create تجاوزات تعليمات مقدمة من المستدعي.

يتضمن مؤلّف Chat زر خيارات Talk بجانب زر بدء/إيقاف Talk. تنطبق الخيارات على جلسة Talk التالية، ويمكنها تجاوز المزوّد، والنقل، والنموذج، والصوت، وجهد الاستدلال، وعتبة VAD، ومدة الصمت، وحشو البادئة. عندما يكون أحد الخيارات فارغًا، يستخدم Gateway الإعدادات الافتراضية المكوّنة عند توفرها أو الإعداد الافتراضي للمزوّد. يؤدي اختيار ترحيل Gateway إلى فرض مسار ترحيل الواجهة الخلفية؛ أما اختيار WebRTC فيُبقي الجلسة مملوكة للعميل ويفشل بدل الرجوع بصمت إلى الترحيل إذا تعذّر على المزوّد إنشاء جلسة متصفح.

في مؤلّف Chat، يكون عنصر تحكم Talk هو زر الموجات بجانب زر الإملاء بالميكروفون. عند بدء Talk، يعرض صف حالة المؤلّف Connecting Talk...، ثم Talk live أثناء اتصال الصوت، أو Asking OpenClaw... أثناء استشارة استدعاء أداة بالزمن الفعلي للنموذج الأكبر المكوّن عبر talk.client.toolCall.

اختبار دخان حيّ للمشرف: يتحقق 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) لإجهاض كل عمليات التشغيل النشطة لتلك الجلسة.

• عند إجهاض تشغيل، يمكن أن يظل نص المساعد الجزئي معروضًا في واجهة المستخدم.
• يستمر Gateway في حفظ نص المساعد الجزئي المُجهض في سجل النسخة عندما توجد مخرجات مخزّنة مؤقتًا.
• تتضمن الإدخالات المحفوظة بيانات وصفية للإجهاض حتى يستطيع مستهلكو النسخ التمييز بين الأجزاء الجزئية الناتجة عن الإجهاض ومخرجات الإكمال العادية.

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

allowInsecureAuth هو مفتاح توافق محلي فقط:

• يسمح لجلسات Control UI على localhost بالمتابعة دون هوية جهاز في سياقات HTTP غير الآمنة.
• لا يتجاوز فحوصات الإقران.
• لا يخفف متطلبات هوية الجهاز البعيد (غير localhost).

• يمكن لمصادقة الوكيل الموثوق الناجحة قبول جلسات Control UI للمشغّل دون هوية جهاز.
• لا يمتد هذا إلى جلسات Control UI ذات دور العقدة.
• لا تزال الوكلاء العكسية عبر local loopback على المضيف نفسه لا تفي بمصادقة الوكيل الموثوق؛ راجع مصادقة الوكيل الموثوق.

• يُخزَّن gatewayUrl في localStorage بعد التحميل ويُزال من عنوان URL.
• إذا مرّرت نقطة نهاية ws:// أو wss:// كاملة عبر gatewayUrl، فقم بترميز قيمة gatewayUrl لعنوان URL حتى يحلل المتصفح سلسلة الاستعلام بشكل صحيح.
• يجب تمرير token عبر جزء عنوان URL (#token=...) كلما أمكن. لا تُرسل الأجزاء إلى الخادم، ما يتجنب تسرب سجلات الطلبات وReferer. لا تزال معاملات الاستعلام القديمة ?token= تُستورد مرة واحدة للتوافق، ولكن كحل احتياطي فقط، وتُزال فورًا بعد التمهيد.
• يُحتفظ بـ password في الذاكرة فقط.
• عند تعيين gatewayUrl، لا تعود واجهة المستخدم إلى بيانات اعتماد التكوين أو البيئة. قدّم token (أو password) صراحةً. غياب بيانات الاعتماد الصريحة خطأ.
• استخدم wss:// عندما يكون Gateway خلف TLS (Tailscale Serve، وكيل HTTPS، وما إلى ذلك).
• لا يُقبل gatewayUrl إلا في نافذة علوية المستوى (غير مضمّنة) لمنع clickjacking.
• يجب على عمليات نشر واجهة التحكم العامة غير ذات الحلقة الراجعة تعيين gateway.controlUi.allowedOrigins صراحةً (الأصول الكاملة). تُقبل تحميلات LAN/Tailnet الخاصة من نفس الأصل من الحلقة الراجعة، أو RFC1918/link-local، أو .local، أو .ts.net، أو مضيفي Tailscale CGNAT من دون تمكين الرجوع إلى رأس Host.
• قد يبذر بدء تشغيل Gateway أصولًا محلية مثل http://localhost:<port> وhttp://127.0.0.1:<port> من الربط والمنفذ الفعليين في وقت التشغيل، لكن أصول المتصفحات البعيدة لا تزال تحتاج إلى إدخالات صريحة.
• لا تستخدم gateway.controlUi.allowedOrigins: ["*"] إلا للاختبار المحلي الخاضع لرقابة مشددة. يعني ذلك السماح لأي أصل متصفح، وليس "مطابقة أي مضيف أستخدمه".
• يفعّل gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback=true وضع الرجوع إلى أصل رأس Host، لكنه وضع أمني خطير.