Control UI: لوحة التحكم داخل المتصفح
OpenClaw Control UI هي لوحة تحكم في المتصفح تأتي مدمجة مع Gateway: openclaw dashboard أمر واحد يفتحها، والجلسات والموافقات والملفات والإعدادات والطرفية كلها في صفحة واحدة. ذكرنا في الدرس السابق أن المداخل اليومية ثلاثة أنواع، وهذا الدرس مخصص لأكثرها استخداماً.
إنها ليست موقعاً سحابياً. Control UI تطبيق صفحة واحدة مبني بـ Vite + Solid، يخدمه مباشرة عملية Gateway الخاصة بك، والعنوان الافتراضي على الجهاز المحلي http://127.0.0.1:18789/ — إذا توقف Gateway لن تفتح الصفحة. هذا هو ثمن الاستضافة الذاتية، وهو أيضاً مصدر ميزة «الحالة والذاكرة وبيانات الاعتماد كلها على عتادك الخاص».
أُعيد بناء Control UI بالكامل في الإصدار v2026.8.1 («OpenClaw 2.0»): المحادثة في المنتصف، والملفات والموافقات والإعدادات والعمل المباشر ملتفة حول المحادثة (للخلفية راجع الجديد في OpenClaw 2.0). يستند هذا الدرس إلى v2026.10.9.
ماذا ستستطيع أن تفعل بعد هذا الدرس
- فتح OpenClaw Control UI باستخدام
openclaw dashboardأوhttp://127.0.0.1:18789/، مع توضيح الفرق بينه وبين نسخة الويب السحابية - إتمام مصادقة Gateway secret والإقران لمرة واحدة للجهاز؛ بحيث يمكن للهاتف بمسح الرمز ولأجهزة أخرى الاتصال
- التمييز بين الأقسام الثلاثة Pages / Sessions / Users في الشريط الجانبي، واستخدام لوحة أوامر Ctrl+K للانتقال السريع
- إرسال الرسائل في صندوق المحادثة وتبديل النماذج، واستخدام لوحة Details لعرض workspace والفرع والاستخدام
- إدارة الجلسات والإعدادات: Pin وإعادة التسمية والأرشفة و Snooze وتوليد روابط مشاركة عامة للقراءة فقط؛ وفي صفحة الإعدادات تغيير المظهر وإدارة الإضافات وتكوين خوادم MCP واستيراد ذاكرة Claude Code / Codex
مشكلتك الحالية
- تتحدث مع Claw في الطرفية دائماً، وتريد الرجوع إلى السجلات القديمة أو معرفة الملفات التي عدّلها فعلاً، لكن الطرفية لا تتيح التمرير بسهولة
- عندما يطلب Claw موافقة تظهر جملة واحدة فقط في القناة، وإذا فوّتها تغرق في الأسفل، وتريد مكاناً مركزياً للعرض والموافقة
- تريد تبديل النماذج وتثبيت الإضافات وتغيير الواجهة دون لمس ملفات الإعدادات — ينقصك منصة تحكم رسومية مريحة
متى تستخدم هذه الطريقة
عندما تحتاج إلى:
- منصة تحكم كاملة الميزات: الجلسات والملفات والموافقات والإعدادات والطرفية كلها في المتصفح
- عرض Claw الخاص بك والتحكم به من الهاتف أو من حاسوب آخر
- القيام بالعمليات اليومية دون لمس الطرفية: فتح جلسة جديدة أو تبديل النموذج أو أرشفة محادثات قديمة كلها بنقرة واحدة
ولا تريد:
- الدخول عبر SSH إلى الجهاز في كل مرة لتعديل
openclaw.json - تصفح سجلات محادثات طويلة داخل TUI في الطرفية
- البحث في ملفات السجلات فقط للاطلاع على موافقة واحدة
🎒 التحضير قبل البدء
- أن تكون قد أكملت دليل الاستخدام اليومي، وتعرف موقع هذا الدرس ضمن المرحلة
- أن يكون Gateway يعمل: في التثبيت: التشغيل في 5 دقائق يجب أن يُظهر
openclaw gateway statusالاستماع على 18789؛ إذا فشل التثبيت راجع أولاً استكشاف أخطاء التثبيت وإصلاحها - متصفح حديث نسبياً: Chrome 147+ / Firefox 150+ / Safari 26.2+ (وفق المصدر الرسمي لشهر 10 من عام 2026)
- (اختياري) تثبيت تطبيق OpenClaw على الهاتف، مع رغبة في الإقران بمسح الرمز
الفكرة الأساسية
ما هو Control UI؟ التعريف الرسمي: تطبيق صفحة واحدة (SPA) مبني بـ Vite + Solid، يخدمه Gateway:
- العنوان الافتراضي
http://<host>:18789/، وعلى الجهاز المحلي هوhttp://127.0.0.1:18789/ - بادئة اختيارية
gateway.controlUi.basePath(مثلاً عند التركيب على مسار فرعي/openclaw) - تتصل الصفحة مباشرة بـ** Gateway WebSocket على نفس المنفذ** — دون خادم وسيط
علاقته بالمدخلين اليوميين الآخرين:
| نقطة الدخول | كيفية الفتح | متى يكون مناسبًا |
|---|---|---|
| Control UI (هذا الدرس) | openclaw dashboard أو الوصول عبر المتصفح 18789 | لوحة تشغيل كاملة الميزات: الجلسات، الموافقات، الملفات، الإعدادات، الطرفية |
| TUI | اكتب في الطرفية openclaw | دون فتح متصفح، لمحادثة سريعة |
| قنوات الدردشة | Feishu / WeChat للشركات / Telegram وغيرها | يأتيك Claw داخل تطبيق المراسلة الذي تستخدمه بالفعل (تطبيق عملي على السيناريوهات) |
احفظ جملة واحدة عن نموذج الأمان: مصادقة Gateway (بـ token أو كلمة مرور) تُنفَّذ قبل إقران الجهاز، وحتى الاتصال عبر loopback المحلي لا يتجاوز المصادقة؛ يستمع Gateway افتراضيًا على localhost فقط (loopback)، على المنفذ 18789. القواعد الكاملة للكشف عن بُعد موجودة في تقوية الأمان (1).
اتبع خطواتي
الخطوة 1: افتح OpenClaw Control UI — المنفذ المحلي 18789
لماذا: يقدّم Control UI خدمته عبر Gateway، فإذا لم يكن Gateway يعمل فلن تفتح الصفحة. تأكد أولًا أنه يعمل، ثم افتح المتصفح.
openclaw dashboardيفترض أن ترى: المتصفح يفتح Control UI تلقائيًا. يمكنك أيضًا الزيارة يدويًا http://127.0.0.1:18789/ (أو http://localhost:18789/).
الصفحة لا تفتح؟ الترتيب الذي توصي به الوثائق الرسمية هو بدء Gateway أولًا:
openclaw gatewayثم حدِّث المتصفح. إذا لم ينجح ذلك، تحقق بندًا بندًا وفق «تنبيهات المخاطر» أدناه.
- فتح المتصفح
http://127.0.0.1:18789/، وترى صفحة تسجيل الدخول أو مساحة العمل
الخطوة 2: أدخل Gateway secret — مصادقة OpenClaw Control UI
لماذا: مصادقة Gateway هي البوابة الأولى، وحتى loopback المحلي لا يتجاوزها. عملية الإعداد المحلية (onboarding) تولّد افتراضيًا Gateway secret بنمط token.
صفحة تسجيل الدخول فيها حقل إدخال Gateway secret واحد فقط: الصق الـ token مباشرة، أو أدخل كلمة المرور يدويًا (gateway.auth.mode يحدد أيهما يُستخدم). يُعرض الـ token المشترك في الطرفية التفاعلية على جهاز Gateway المضيف:
openclaw gateway auth-token --showيفترض أن ترى: تطبع الطرفية الـ token المشترك. الصقه في حقل Gateway secret لتتصل بمساحة العمل؛ ويظهر مؤشر الاتصال في الزاوية السفلية اليسرى حالة الاتصال الحالية.
💡 أين يُخزَّن الـ secret؟
بعد نجاح الاتصال، تخزّن واجهة المستخدم الـ secret في session storage لتبويب المتصفح الحالي فقط في نمط token (وبالنسبة لمصدر Gateway الحالي فقط)؛ أما كلمة المرور فتبقى في الذاكرة فقط ولا تُكتب إلى القرص أبدًا. بعد اكتمال الإقران، تستخدم اتصالات المتصفح اللاحقة الـ token الخاص بكل جهاز، فلا حاجة لإدخال الـ secret مرة أخرى.
- نجاح مصادقة Gateway secret والدخول إلى الواجهة بعد تسجيل الدخول
الخطوة 3: الموافقة على إقران الجهاز — أول اتصال لمتصفح جديد
لماذا: بعد نجاح المصادقة، يحتاج أول اتصال من متصفح/جهاز جديد عادةً إلى موافقة إقران لمرة واحدة — لتسجيل «أنا أعرف هذا المتصفح» في مخزن بيانات الاعتماد.
أسهل طريقة على جهاز Gateway المضيف هي نفس openclaw dashboard من الخطوة 1: فهي تفتح رابط إقران قصير الأجل ولمرة واحدة يتيح للمتصفح الحالي الحصول مباشرة على بيانات اعتماد مسؤول دائمة دون موافقة يدوية.
عند استخدام متصفح/جهاز آخر، تعرض الصفحة disconnected (1008): pairing required وتنتظر؛ في هذه الحالة نفِّذ على جهاز Gateway المضيف:
openclaw devices list
openclaw devices approve <requestId>يفترض أن ترى: تبقى الصفحة مفتوحة وتتصل تلقائيًا بعد الموافقة (Check now لإعادة المحاولة فورًا). تُحفظ الأجهزة التي وُافق عليها، فلا تحتاج إلى إقران لاحقًا؛ ولإلغاء ذلك استخدم openclaw devices revoke --device <id> --role <role>.
💡 يمكن الموافقة تلقائيًا على loopback المحلي
الاتصالات المحلية القادمة مباشرة من 127.0.0.1 / ::1 وبدون ترويسات وسيط تحصل على موافقة تلقائية على إقران الجهاز بعد نجاح مصادقة Gateway (يظل الـ token / كلمة المرور مطلوبَين أولًا، فهذا ليس تجاوزًا للمصادقة). لفرض موافقة يدوية على كل جهاز، عيِّن gateway.nodes.pairing.autoApproveLocal: false.
⚠️ نافذة التصفح المتخفي تُعَد «متصفحًا جديدًا» في كل مرة
كل ملف تعريف متصفح يولّد معرّف جهاز مستقلًا؛ ومسح بيانات المتصفح، أو استخدام نافذة التصفح المتخفي (أو Firefox مضبوط على «عدم حفظ السجل أبدًا») يؤدي إلى فقدان هوية الجهاز المُقرن، فيلزم الإقران من جديد في المرة التالية. الأسهل يوميًا هو الالتزام بملف تعريف متصفح ثابت.
- اكتمال إقران المتصفح والدخول إلى مساحة عمل Control UI
الخطوة 4: تعرَّف على التنقل ثلاثي المناطق — Pages و Sessions و Users
لماذا: في 2.0 أصبحت المحادثة في المنتصف، مع شريط تنقل على اليسار يدير كل شيء. ميّز بين العروض الثلاثة، وستجد لكل العمليات اللاحقة مكانها.
| العرض | ماذا يحتوي | ما الذي تفعله هنا غالبًا |
|---|---|---|
| Pages | الصفحات المدمجة ولوحات المعلومات ومداخل الإضافات | فتح صفحات Automations و Templates و Systems وغيرها |
| Sessions | جميع الجلسات | استرجاع المحادثات القديمة وبدء جلسات جديدة |
| Users | المتصلون الآن | معرفة من هو متصل ومشاهدة نشاط الآخرين |
البنية الثابتة لشريط التنقل: في الأعلى صورة Agent الحالي (انقر عليها لفتح قائمة Agent)، وتحتها زر + (New conversation، لبدء جلسة جديدة)، وفي الأسفل Home و Inbox وقائمة حسابك.
ثلاث حيل للاستخدام الفوري:
- Ctrl+K (على Mac: ⌘K): لوحة الأوامر — للانتقال بين الصفحات وتبديل الجلسات والبحث عن الأوامر
- Ctrl+B (على Mac: ⌘B): طي / توسيع الشريط الجانبي
- Ctrl+Shift+O (على Mac: ⌘⇧O): اختصار New Session في المتصفح، يركّز مباشرة على مربع الدردشة
يفترض أن ترى: عند النقر على عرض Sessions، تصطف الجلسات في ثلاثة أقسام —
Other: المحادثات العادية؛ Groups: المجموعات / الغرف؛ Coding: الجلسات المرتبطة بـ worktree أو عقدة exec، ويظهر في سطرها
repo ⎇ branchشرائح My sessions / Involving me / All owners في سطر العنوان لتبديل عرض جلسات مَن
Filter & sort للتصفية حسب الحالة (Active / Snoozed / Archived / All) والمجموعة والترتيب؛ وShow message preview لتفعيل معاينة الرسائل
يمكنك استخدام Ctrl+K لفتح لوحة الأوامر والتبديل بين العروض الثلاثة
الخطوة 5: التحدث مع Claw — composer والنماذج ولوحة Details
لماذا: المحادثة هي مركز Control UI. إلى جانب إرسال الرسائل، تتناول هذه الخطوة التعرف على الأدوات القليلة التي تجعلك «ترى ما يفعله».
انقر + في شريط التنقل (أو New session في Sessions): تتيح لك صفحة New session اختيار agent وWorkspace (المشاريع المحفوظة / المجلدات الأخيرة / رابط المستودع) والنموذج، ثم إرسال الرسالة الأولى.
ينبغي أن ترى:
- تظهر الردود بشكل متدفق؛ وتُطوي الجولة المكتملة العملية في سطر واحد Worked for 2m 3s، انقر عليه لعرض تفاصيل استدعاءات الأدوات
- يحتوي مربع المحادثة (composer) علىمحدد النماذج — يمكنك تبديل النموذج دون لمس ملفات الإعدادات (مراجعة الصياغة:
provider/model، راجع نظرة عامة على ربط النماذج) - تُظهرحلقة السياق في الـ composer ملخص الاستخدام ورموز الجولة الأخيرة وحدود الخطة؛ وView context يفتح التقرير الكامل
- لوحة Details في رأس المحادثة: Environment (اسم workspace والفرع وworktree وجهاز التنفيذ والنموذج)، Changes (طلبات الدمج وإحصاءات التغييرات والفحوصات)
- عندما يحتاج Claw إلى موافقة أو يطرح سؤالًا، يظهر أيقونة تنبيه على صف الجلسة المقابل في الشريط الجانبي، وانقر عليها لرؤية الطلب المحدد
يُؤخذ اسم الجلسة الجديدة تلقائيًا من المهمة الافتتاحية، ولا يتغير بعد ذلك إلا إذا أعدت أنت أو الـ agent تسميته صراحةً.
💡 افتح جلسة صغيرة في الخلفية دون مقاطعة المحادثة الحالية
افتح لوحة الأوامر بـ Ctrl+K، واسحب صورة أو ملفًا إلى اللوحة (أو الصق صورة مباشرة)، فتتحول اللوحة إلى وضع New session؛ أضف تعليمة، واضبط إعدادات الجلسة، ثم أرسل بـ Ctrl+Enter — المحادثة الحالية لا تتأثر إطلاقًا، ولن يُرسل الملف من تلقاء نفسه.
- أرسل رسالة واحدة وتلقَّ ردًا؛ وافتح لوحة Details مرة واحدة على الأقل
الخطوة 6: إدارة الجلسات — Pin وإعادة التسمية والأرشفة والمشاركة
لماذا: عندما تكثر المحادثات، تحتاج إلى تنظيمها. قائمة المحادثة (بالنقر بزر الفأرة الأيمن على الصف في الشريط الجانبي، أو قائمة الإجراءات في أعلى الدردشة) تجمع الإجراءات الشائعة الاستخدام في مكان واحد.
| الإجراء | التأثير |
|---|---|
| Pin / Unpin | تثبيت في قسم Pinned أعلى Sessions |
| Rename | انقر عنوان رأس المحادثة للتعديل مباشرة؛ Enter للحفظ وEscape للإلغاء |
| Archive / Restore | طي من قائمة Active (Ctrl+Shift+A لأرشفة المحادثة الحالية)، ويبقى السجل قابلًا للقراءة، مع إمكانية Undo |
| Snooze / Wake | إخفاء مؤقت: 1 ساعة / 3 ساعات / الليلة 18:00 / صباح الغد 9:00 / صباح الاثنين القادم 9:00 |
| Move to group | نقل إلى مجموعة مخصصة؛ تُخزَّن أسماء المجموعات وترتيبها في Gateway وتتبعك عبر المتصفحات |
| Icon & color | إضافة emoji / أيقونة وشريط لوني لصف الجلسة (قائمة Advanced) |
Snooze هو مجرد «إخفاء مؤقت»: تستمر الجلسة نفسها في العمل كالمعتاد — إذا أرسلت إليها رسالة، أو أنهى الـ agent جولة، أو حل وقت الاستيقاظ، تعود من تلقاء نفسها إلى قائمة Active؛ ولتستيقظ مبكرًا، استخدم Wake session من القائمة.
مشاركة جلسة علنًا: في رأس المحادثة Session sharing → Enable public access… → أكد Make public → Copy public link. يطّلع حاملو الرابط على نص المحادثة والصور المؤهلة وملخصات الأدوات المطوية بصفةللقراءة فقط؛ ولا يمكنهم إرسال رسائل ولا يحصلون على صلاحياتك.
⚠️ اقرأ بنفسك قبل النشر
نص الصفحة العامةلا يخضع لأي تنقية — أي كلمات مرور أو مفاتيح ظهرت في المحادثة تبقى ظاهرة كما هي. راجع المحادثة قبل النشر؛ وإغلاق الوصول العام لا يسترد النسخ التي حفظها الآخرون بالفعل.
ينبغي أن ترى: الجلسات المثبتة بـ Pin تظهر في قسم Pinned أعلى Sessions؛ والجلسات المؤرشفة تختفي من قائمة Active مع إمكانية Undo على شريط التأكيد، ويبقى السجل قابلًا للقراءة.
- ثبّت جلسة مستخدمة كثيرًا بـ Pin في الأعلى، وأرشف جلسة قديمة
الخطوة 7: صفحة الإعدادات واللوحة الجانبية — المظهر والإضافات و MCP والطرفية
لماذا: تتركز الإعدادات الرسومية اليومية في Settings؛ بينما تتدلى أدوات العمل في اللوحة الجانبية على يمين المحادثة.
Settings (قائمة الحساب أسفل الشريط الجانبي → Settings):
- Appearance: مظهر السمة، حتى أيقونة تبويب المتصفح يمكن تغييرها (Default / Agent avatar / Lobsterdex)
- Plugins: تثبيت الإضافات واكتشافها بنقرة واحدة
- Updates: يظهر شارة Available عند توفر إصدار جديد على قناتي stable / beta (ويوجد مدخل Updates أيضًا في قائمة الحساب)
- MCP: إضافة / تمكين / تعطيل خوادم MCP (ثلاث وسائط نقل: Streamable HTTP وSSE وstdio) — للاستخدام المتقدم راجع ربط MCP
- Import Memory: استيراد الذاكرة المحلية من Claude Code / Codex / Hermes إلى agent معين — التفاصيل في نظام الذاكرة
- Labs: تشغيل الميزات التجريبية، مثل Templates (صفحة اكتشاف للقوالب الرسمية إضافية في Pages) وSpeech bubbles (عرض المحادثة على شكل فقاعات)
- يبحث Search settings في الأعلى حسب الصفحة واسم حقل الإعداد، فلا حاجة للتنقل واحدًا واحدًا
اللوحة الجانبية (إلى يمين المحادثة، تُفتح عبر قائمة + أو قائمة Layout في الرأس):
- Terminal: طرفية المشغّل، مفعّلة افتراضيًا (
gateway.terminal.enabled)، تتطلب صلاحيةoperator.admin، وتفتح PTY على الجهاز المضيف داخل مساحة عمل الـ agent الحالية؛ الاختصارCtrl+`(Ctrl مع علامة الاقتباس العكسية) للتبديل السريع - Browser: تُعرض هنا نتائج عمليات المتصفح في Claw
- Files: تصفح ملفات مساحة العمل؛ عند التحويم على سطر ملف يظهر Download file، ويمكن معاينة PDF حتى 16 MiB كحد أقصى؛ من قائمة ⋯ في شريط أدوات المعاينة، يضيف خيار Attach to session الملف إلى الرسالة التالية
- Subagents: عرض حالة تشغيل الوكلاء الفرعيين وسجل transcript للقراءة فقط (يمكن أيضًا استخدام أوامر مثل
/subagents listفي المحادثة) - Processes: حالة ومخرجات أوامر exec التي تعمل في خلفية الجلسة، وStop يوقف تلك العملية المحددة بدقة
اسأل OpenClaw: Settings → Ask OpenClaw (أو تبويب Ask OpenClaw في شريط الإرساء في Home) — وكيل مخصص لإدارة تثبيت النظام وإصلاحه، يكفي أن تكتب configure gateway أو import memory في المحادثة لتشغيل المعالج الإرشادي.
⚠️ طرفية المشغّل هي shell على الجهاز المضيف
الطرفية المحلية لـ Gateway غير مقيدة بالحماية (sandbox) وتَرِث بيئة عملية Gateway — كل ما يستطيع Gateway قراءته من بيانات اعتماد تستطيع هي قراءته أيضًا، كما أن كتابة الملفات مباشرة تتجاوز قيودًا مثل OPENCLAW_CONFIG_READONLY. إذا لم ترغب في هذه القدرة: عيّن gateway.terminal.enabled: false، أو استخدم عند النشر متغير البيئة OPENCLAW_DISABLE_GATEWAY_LOCAL_TERMINALS=1 لتعطيلها نهائيًا.
ينبغي أن ترى: في أعلى Settings مربع بحث Search settings — كتابة كلمة مثل Typography تقفز مباشرة إلى الإعداد المقابل في Appearance؛ ويمكن سحب تبويبات اللوحة الجانبية لإعادة ترتيبها وإغلاق كل منها على حدة دون أن يؤثر ذلك على بعضها.
- اعثر في Settings على صفحتي MCP و Import Memory؛ وافتح لوحة Terminal مرة واحدة على الأقل
الخطوة 8 (اختيارية): الوصول عن بُعد ومن الهاتف إلى Control UI
لماذا: يعمل Claw على جهاز منزلي أو VPS، ويجب أن تتمكن من الاتصال حتى عندما لا تكون أمامه.
الطريقة A (موصى بها): كشف HTTPS عبر Tailscale Serve
openclaw gateway --tailscale serveافتح https://<magicdns>/. عند تفعيل gateway.auth.allowTailscale: true يمكن المرور عبر مصادقة هوية Tailscale، كما أن المتصفحات التي تحمل هوية الجهاز مسبقًا يمكنها تخطي رحلة الذهاب والإياب في الاقتران.
الطريقة B: الاقتران بمسح رمز QR من الهاتف
المسؤول الذي تم اقترانه مسبقًا في Control UI: Devices → Pair device لتوليد رمز QR → في تطبيق الهاتف Settings → Gateway امسح الرمز (أو الصق رمز الإعداد) → عند ظهور Pending approval راجع الدور والصلاحيات نظرة سريعة ثم وافق. توليد رمز الإعداد يتطلب operator.admin.
الطريقة C: التثبيت كـ PWA
يتضمن Control UI ملف manifest و service worker مدمجين، ويمكن للمتصفحات الحديثة «تثبيته» كتطبيق مستقل؛ بعد التثبيت يستطيع Web Push إرسال الإشعارات حتى والتبويب مغلق — بما في ذلك موافقات exec / الإضافات المعلقة.
⚠️ لا تعرضه مباشرة على الإنترنت العام
يستمع Gateway افتراضيًا على الجهاز المحلي فقط؛ وإذا غيّرت الاستماع إلى عنوان غير loopback فيجب إعداد المصادقة وإلا رفض الإقلاع (fail closed). عنوان http://<内网IP> (أي عنوان IP للشبكة المحلية) يفتح لكنه يعد نقلًا منخفض المستوى، فاستخدم HTTPS قدر الإمكان. القواعد الكاملة في التقوية الأمنية (1).
ينبغي أن ترى: بالطريقة A يفتح https://<magicdns>/ نفس Control UI المتاح محليًا؛ بالطريقة B يتصل التطبيق تلقائيًا بعد مسح الرمز بالهاتف، وبعد الموافقة على Pending approval ينجح الاقتران؛ بالطريقة C يعمل Control UI بعد التثبيت في نافذة تطبيق مستقلة دون احتلال تبويب في المتصفح.
- (اختياري) أكمل الاقتران بمسح الرمز من الهاتف، أو أمكن فتح Control UI عبر HTTPS الخاص بـ Tailscale
نقطة التحقق ✅
- يمكن لـ
openclaw dashboardفتح Control UI، والعنوان المحليhttp://127.0.0.1:18789/ - نجحت مصادقة Gateway secret، وأكمل المتصفح اقتران الجهاز لمرة واحدة
- تستطيع ذكر ما يوضع في Pages / Sessions / Users، و Ctrl+K يفتح لوحة الأوامر
- أرسلت رسالة في Control UI، وبدّلت النموذج، وفتحت لوحة Details
- أنجزت عملية إدارة جلسة واحدة على الأقل (Pin / أرشفة / إعادة تسمية — أي منها)
تنبيهات للمزالق
❌ الصفحة لا تفتح أو تظهر فارغة تمامًا
ثلاث طبقات من الأسباب، افحصها بالترتيب:
- Gateway لا يعمل: صفحة Control UI تخدمها عملية Gateway، فإذا توقفت فلن تفتح حتمًا. شغّل أولًا
openclaw gateway(تشغيل أمامي لمراقبة السجلات)، أو تأكد من أن خدمة الخلفية تعمل - إضافة متصفح تحجب تطبيقات الوحدات: إذا كانت الصفحة فارغة و DevTools لا يظهر خطأً، فالوثائق الرسمية تشير إلى «الإضافات التي تُحقن في جميع الصفحات (خاصة تلك التي تحمل content script بنمط
<all_urls>)». عطّل هذه الإضافات، أو جرّب نافذة التصفح المتخفي أو ملف تعريف نظيف؛ ولوحة الاسترداد المدمجة في الصفحة Try again يمكنها إعادة التحميل مباشرة - بعد التحديث تظهر رسالة Protocol mismatch: تبويب قديم أو ذاكرة service worker لا تزال تشغل حزمة الواجهة السابقة للتحديث. أولًا
openclaw dashboardأعد الفتح + تحديث قسري؛ إن لم ينجح فامسح بيانات الموقع لذلك المصدر، أو تحقق في نافذة تصفح متخفي
على Windows هناك حالة إضافية: العنوان المضيف 127.0.0.1 يعمل بسلام لكن عنوان الشبكة المحلية لا يفتح — جدار الحماية أو سياسة المجموعة تحجب عنوان LAN. شغّل على جهاز Windows openclaw gateway status --deep، وسيبلّغ عن المنافذ المشتبه بحجبها وقواعد جدار الحماية المحلي.
❌ disconnected (1008): pairing required يستمر في الدوران دون توقف
السبب: الاتصال الأول لمتصفح جديد يتطلب موافقة اقتران لمرة واحدة، والطلب لم يوافق عليه أحد بعد.
الإجراء الصحيح: أبقِ الصفحة مفتوحة (ستتصل تلقائيًا بعد الموافقة)، وعلى جهاز Gateway راقب الطلبات بـ openclaw devices list ووافق بـ openclaw devices approve <requestId>. يجب التمييز بين شكلين للفشل: الرفض الصريح يظهر Access request declined (يمكن النقر على Request again لإعادة الطلب)؛ والإهمال يظهر Access request expired (إعادة فتح الصفحة سترسل الطلب مرة أخرى).
انتبه: إذا تغيّر الدور أو الصلاحيات عند إعادة محاولة المتصفح، فسيحل الطلب الجديد بـ requestId محل الطلب القديم — أعد تنفيذ list مرة قبل الموافقة، ولا توافق على طلب منتهي الصلاحية بالفعل.
❌ في وضع token يُرفض حتى متصفح الجهاز المحلي
السبب: عندما يُقلع Gateway في وضع token دون تهيئة token، يولّد token تشغيل مؤقتًا — لا يُكتب في التهيئة ولا يمكن استرجاعه، وأي متصفح لم يحصل عليه يُرفض، بلا استثناء حتى الجهاز المحلي.
الإجراء الصحيح (خطوات الإصلاح الثلاث من الوثائق الرسمية):
openclaw doctor --generate-gateway-token # 生成正式 token 写进配置
# 然后重启 Gateway
openclaw gateway auth-token --show # 交互式终端里查看,粘贴进登录页❌ المتصفح قديم جدًا ولا يمكن الدخول إلى الواجهة
السبب: يتطلب Control UI قدرات متصفح حديثة نسبيًا. وفقًا للموقف الرسمي (شهر 10 من عام 2026): Chrome 147+ وFirefox 150+، بالإضافة إلى Safari 26.2+ على macOS 26.2 / iOS 26.2 / iPadOS 26.2 (أو Chrome / Firefox صدر خلال الأشهر الستة الأخيرة).
الإجراء الصحيح: قم بترقية المتصفح. المتصفحات التي تفتقر إلى القدرات الأساسية سترى أولًا صفحة تنبيه بالتحديث؛ ومن لا يدعم البرامج النصية للوحدات (module scripts) إطلاقًا سيعرض مباشرة This browser is not supported. إذا واجهت ذلك داخل تطبيق أصلي يمكنك النقر على Open in browser للفتح عبر المتصفح الافتراضي للنظام.
❌ نوافذ التصفح المتخفي / الخصوصية تتطلب إقرانًا جديدًا في كل مرة
السبب: لكل ملف تعريف متصفح معرّف جهاز واحد؛ والنوافذ التي تتخلص من بيانات الموقع (التخفي، وخيار «عدم تذكر التاريخ أبدًا» في Firefox) تُعامل في كل مرة كمتصفح جديد.
الإجراء الصحيح: استخدم ملف تعريف ثابت للاتصال بـ Control UI في الاستخدام اليومي؛ وعندما تطول قائمة الأجهزة المُقرنة، استخدم openclaw devices remove <deviceId> لحذف الإدخالات القديمة التي لم تعد مستخدمة.
نصائح متقدمة (اختيارية)
إغلاق Control UI لا يوقف الروبوت. gateway.controlUi.enabled: false يسري فورًا——فهو يوقف الصفحة والموارد الثابتة فقط، بينما يستمر الروبوت واتصالات Gateway القائمة بالعمل؛ وإعادته إلى true يستأنف الخدمة، وتُستكمل الموارد الناقصة في الخلفية. لكن تعديل basePath / الدليل الجذري للموارد لا يزال يتطلب إعادة تشغيل Gateway:
{
gateway: {
controlUi: {
enabled: true,
basePath: "/openclaw", // 挂到子路径;改这个要重启
},
},
}شريط الإعداد للقراءة فقط. Gateway الذي يُشغَّل بـ OPENCLAW_CONFIG_READONLY=1 (أو OPENCLAW_NIX_MODE=1)، يعرض أعلى Control UI الرسالة Gateway configuration is read-only——أي أن الإعداد متاح للعرض فقط دون تعديل. إذا أردت توجيه الجميع إلى سير عملتهم الخاصة لتعديل الإعداد، فاضبط OPENCLAW_CONFIG_READONLY_NOTICE ليكون نص تنبيهك (عند الانتهاء بمسافة + URL مطلق سيُضاف تلقائيًا رابط Learn more إضافي).
مع عدة Gateway لا تخطئ في التمييز. عند إدارة عدة أجهزة Gateway في آن واحد، اضبط لكل منها gateway.controlUi.environment:
{
gateway: {
controlUi: {
environment: { label: "edge", color: "amber" },
},
},
}سيظهر في المتصفح شريط لون علوي بارتفاع 2px، ووسم في الشريط الجانبي، ولاحقة في العنوان، وfavicon مطابق، فتُميّز بنظرة واحدة أي جهاز أنت متصل به. الألوان المتاحة هي teal / amber / purple / coral / pink / blue / green / red / gray، والوسم محدود بـ 1–24 حرفًا.
لا تقلق عند انقطاع الاتصال. عند انقطاع الاتصال، تبقى الأدلة المحمّلة ومحرر الأتمتة وخيارات Import Memory وسجل النشاط وقائمة الموافقات في الذاكرة ولا تُفقد؛ ويظهر المؤشر في الزاوية السفلية اليسرى Reconnecting… لإعادة الاتصال تلقائيًا، وعند توقف الاستعادة التلقائية يظهر زر Retry. لكن تذكّر أمرًا واحدًا: إجراءات Gateway مثل حفظ التعديلات والموافقة على الطلبات تتطلب اتصالًا حيًا، وإعادة الاتصال لا تعيد تنفيذها تلقائيًا؛ فبعد إعادة الاتصال أعد يدويًا العمليات التي لم تُؤكَّد.
خلاصة هذا الدرس
✅ OpenClaw Control UI هو وحدة تحكم بالمتصفح لخدمة Gateway: افتحه بـ openclaw dashboard، على الجهاز المحلي http://127.0.0.1:18789/، ويتواصل مع Gateway عبر WebSocket على نفس المنفذ——ليس موقعًا سحابيًا.
✅ اجتزت البوابات الثلاث للاتصال بسلاسة: Gateway secret (token / كلمة مرور) → إقران جهاز لمرة واحدة (openclaw dashboard في خطوة واحدة أو devices list / approve) → ثم بعد ذلك اتصال بلا إقران عبر token الجهاز.
✅ حفظت خريطة الواجهة: مسار التنقل = Pages / Sessions / Users + صورة agent في الأعلى + Home / Inbox / الحساب في الأسفل؛ لوحة الأوامر Ctrl+K، وطي الشريط الجانبي بـ Ctrl+B، وفتح جلسة جديدة بـ Ctrl+Shift+O.
✅ للإجراءات اليومية مداخل ثابتة: مربع المحادثة لتبديل النموذج، وDetails لعرض مساحة العمل والاستخدام، وقائمة الجلسة لـ Pin / الأرشفة / Snooze، وSession sharing لإصدار رابط عام للقراءة فقط، وSettings لإدارة المظهر / الإضافات / MCP / استيراد الذاكرة، واللوحة الجانبية لعرض Terminal / Browser / Files / Subagents.
| مفتاح الإعداد / الأمر | الوظيفة | ملاحظات |
|---|---|---|
gateway.controlUi.enabled | تشغيل / إيقاف Control UI | يسري فورًا؛ وإيقافه لا يؤثر على الروبوت والاتصالات القائمة |
gateway.controlUi.basePath | بادئة مسار فرعي | مثل /openclaw؛ وتعديله يتطلب إعادة تشغيل Gateway |
gateway.auth.mode | token / password | في صفحة تسجيل الدخول أدخل القيمة المقابلة لـ Gateway secret |
gateway.terminal.enabled | مفتاح طرفية المشغّل | مفعّل افتراضيًا؛ ويتطلب operator.admin |
openclaw dashboard | فتح / إصلاح الإقران | رابط إقران لمرة واحدة قصير الأجل |
openclaw gateway auth-token --show | عرض token المشاركة | يُشغَّل في طرفية تفاعلية على مضيف Gateway |
openclaw devices list / approve | الموافقة على الإقران | عند أول اتصال لمتصفح جديد |
openclaw gateway --tailscale serve | وصول HTTPS عن بُعد | الطريقة الموصى بها هي Tailnet |
للاطلاع على مرجع سريع كامل للأوامر والإعدادات، راجع مرجع سريع لأوامر CLI والإعدادات.
استعراض الدرس التالي
مربع المحادثة في Control UI لا يقتصر على الكتابة——أوامر الشرطة مثل /model و/think و/new تعمل بنفس الطريقة في نسخة الويب وقنوات المحادثة. الدرس التالي دورة سريعة في أوامر المحادثة: /model و/think وأوامر الشرطة يستعرض الدفعة الأكثر استخدامًا منها.
ستتعلم:
- عائلة
/model:/model listلعرض الأدلة، و/model <name>للتبديل، و/model statusلعرض الحالة /think <level>لضبط مستوى التفكير، و/fastللوضع السريع/newو/resetلإدارة دورة حياة الجلسة/skill <name>المدخل الشامل——استدعِ المهارات كأوامر