الانتقال إلى المحتوى الرئيسي

​
TUI (واجهة الطرفية)

​
البدء السريع

  1. ابدأ Gateway.
openclaw gateway
  1. افتح TUI.
openclaw tui
  1. اكتب رسالة واضغط Enter.
Gateway بعيد: 
openclaw tui --url ws://<host>:<port> --token <gateway-token>
استخدم --password إذا كان Gateway لديك يستخدم مصادقة كلمة المرور.

​
ما الذي تراه

  • الترويسة: عنوان URL للاتصال، والوكيل الحالي، والجلسة الحالية.
  • سجل الدردشة: رسائل المستخدم، وردود المساعد، وإشعارات النظام، وبطاقات الأدوات.
  • سطر الحالة: حالة الاتصال/التشغيل (جارٍ الاتصال، جارٍ التشغيل، جارٍ التدفق، خامل، خطأ).
  • التذييل: حالة الاتصال + الوكيل + الجلسة + النموذج + think/fast/verbose/reasoning + أعداد الرموز + deliver.
  • الإدخال: محرر نصي مع إكمال تلقائي.

​
النموذج الذهني: الوكلاء + الجلسات

  • الوكلاء هم معرّفات فريدة (مثل main وresearch). ويعرض Gateway القائمة.
  • تنتمي الجلسات إلى الوكيل الحالي.
  • تُخزَّن مفاتيح الجلسات بالشكل agent:<agentId>:<sessionKey>.
    • إذا كتبت /session main، فستقوم TUI بتوسيعه إلى agent:<currentAgent>:main.
    • إذا كتبت /session agent:other:main، فستنتقل إلى جلسة ذلك الوكيل صراحةً.
  • نطاق الجلسة:
    • per-sender (الافتراضي): لكل وكيل جلسات عديدة.
    • global: تستخدم TUI دائمًا الجلسة global (وقد يكون المنتقي فارغًا).
  • يكون الوكيل الحالي + الجلسة الحالية ظاهرين دائمًا في التذييل.

​
الإرسال + التسليم

  • تُرسل الرسائل إلى Gateway؛ ويكون التسليم إلى الموفّرين معطلًا افتراضيًا.
  • لتفعيل التسليم:
    • /deliver on
    • أو من لوحة Settings
    • أو ابدأ باستخدام openclaw tui --deliver

​
أدوات الاختيار + التراكبات

  • منتقي النموذج: يسرد النماذج المتاحة ويضبط تجاوز الجلسة.
  • منتقي الوكيل: اختر وكيلًا مختلفًا.
  • منتقي الجلسة: يعرض الجلسات الخاصة بالوكيل الحالي فقط.
  • Settings: تبديل deliver، وتوسيع مخرجات الأدوات، وإظهار التفكير.

​
اختصارات لوحة المفاتيح

  • Enter: إرسال الرسالة
  • Esc: إيقاف التشغيل النشط
  • Ctrl+C: مسح الإدخال (اضغط مرتين للخروج)
  • Ctrl+D: خروج
  • Ctrl+L: منتقي النموذج
  • Ctrl+G: منتقي الوكيل
  • Ctrl+P: منتقي الجلسة
  • Ctrl+O: تبديل توسيع مخرجات الأدوات
  • Ctrl+T: تبديل إظهار التفكير (يعيد تحميل السجل)

​
أوامر الشرطة المائلة

الأساسية:
  • /help
  • /status
  • /agent <id> ‏(أو /agents)
  • /session <key> ‏(أو /sessions)
  • /model <provider/model> ‏(أو /models)
عناصر تحكم الجلسة:
  • /think <off|minimal|low|medium|high>
  • /fast <status|on|off>
  • /verbose <on|full|off>
  • /reasoning <on|off|stream>
  • /usage <off|tokens|full>
  • /elevated <on|off|ask|full> ‏(الاسم البديل: /elev)
  • /activation <mention|always>
  • /deliver <on|off>
دورة حياة الجلسة:
  • /new أو /reset ‏(إعادة تعيين الجلسة)
  • /abort ‏(إيقاف التشغيل النشط)
  • /settings
  • /exit
تُمرَّر أوامر الشرطة المائلة الأخرى الخاصة بـ Gateway ‏(مثل /context) إلى Gateway وتُعرض كمخرجات نظام. راجع أوامر الشرطة المائلة.

​
أوامر shell المحلية

  • ابدأ السطر بالبادئة ! لتشغيل أمر shell محلي على مضيف TUI.
  • تطلب TUI مرة واحدة لكل جلسة السماح بالتنفيذ المحلي؛ وإذا رفضت، يبقى ! معطلًا لتلك الجلسة.
  • تُشغَّل الأوامر في shell جديد وغير تفاعلي داخل دليل العمل الخاص بـ TUI ‏(من دون cd/env دائم).
  • تتلقى أوامر shell المحلية المتغير OPENCLAW_SHELL=tui-local في بيئتها.
  • تُرسل ! منفردة كرسالة عادية؛ ولا تؤدي المسافات البادئة إلى تشغيل التنفيذ المحلي.

​
مخرجات الأدوات

  • تظهر استدعاءات الأدوات كبطاقات تحتوي على الوسائط + النتائج.
  • يبدّل Ctrl+O بين العرضين المطوي والموسع.
  • أثناء تشغيل الأدوات، تتدفق التحديثات الجزئية إلى البطاقة نفسها.

​
ألوان الطرفية

  • تُبقي TUI نص جسم المساعد بلون المقدمة الافتراضي في طرفيتك حتى تبقى الطرفيات الداكنة والفاتحة مقروءة.
  • إذا كانت طرفيتك تستخدم خلفية فاتحة وكان الاكتشاف التلقائي غير صحيح، فاضبط OPENCLAW_THEME=light قبل تشغيل openclaw tui.
  • ولإجبار اللوحة الداكنة الأصلية بدلًا من ذلك، اضبط OPENCLAW_THEME=dark.

​
السجل + التدفق

  • عند الاتصال، تحمّل TUI أحدث السجل (الافتراضي 200 رسالة).
  • تُحدَّث الردود المتدفقة في موضعها حتى الانتهاء.
  • كما تستمع TUI إلى أحداث أدوات الوكيل للحصول على بطاقات أدوات أغنى.

​
تفاصيل الاتصال

  • تسجّل TUI نفسها لدى Gateway على أنها mode: "tui".
  • تعرض عمليات إعادة الاتصال رسالة نظام؛ وتُعرض فجوات الأحداث في السجل.

​
الخيارات

  • --url <url>: عنوان URL لـ Gateway WebSocket ‏(الافتراضي من التكوين أو ws://127.0.0.1:<port>)
  • --token <token>: رمز Gateway المميز (إذا كان مطلوبًا)
  • --password <password>: كلمة مرور Gateway ‏(إذا كانت مطلوبة)
  • --session <key>: مفتاح الجلسة (الافتراضي: main، أو global عندما يكون النطاق عامًا)
  • --deliver: تسليم ردود المساعد إلى الموفّر (معطّل افتراضيًا)
  • --thinking <level>: تجاوز مستوى التفكير عند الإرسال
  • --message <text>: إرسال رسالة أولية بعد الاتصال
  • --timeout-ms <ms>: مهلة الوكيل بالمللي ثانية (الافتراضي من agents.defaults.timeoutSeconds)
  • --history-limit <n>: عدد إدخالات السجل التي يجب تحميلها (الافتراضي 200)
ملاحظة: عندما تضبط --url، لا تعود TUI إلى بيانات الاعتماد الموجودة في التكوين أو البيئة. مرّر --token أو --password صراحةً. ويُعد غياب بيانات الاعتماد الصريحة خطأً.

​
استكشاف الأخطاء وإصلاحها

لا توجد مخرجات بعد إرسال رسالة:
  • شغّل /status في TUI لتأكيد أن Gateway متصل وخامل/مشغول.
  • تحقق من سجلات Gateway: ‏openclaw logs --follow.
  • تأكد من أن الوكيل يمكنه التشغيل: ‏openclaw status وopenclaw models status.
  • إذا كنت تتوقع ظهور الرسائل في قناة دردشة، فعّل التسليم (/deliver on أو --deliver).

​
استكشاف مشكلات الاتصال وإصلاحها

  • disconnected: تأكد من أن Gateway يعمل وأن --url/--token/--password صحيحة.
  • لا يوجد وكلاء في المنتقي: تحقق من openclaw agents list ومن تكوين التوجيه لديك.
  • منتقي الجلسة فارغ: قد تكون في النطاق العام أو لا توجد لديك جلسات بعد.

​
ذو صلة

  • Control UI — واجهة تحكم قائمة على الويب
  • مرجع CLI — المرجع الكامل لأوامر CLI